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Preface 


Drupal has its roots in building and supporting online communities. These roots 
have helped Drupal meet the needs of schools, teachers, and students in countless 
countries, and in countless different learning contexts. Compared to a traditional 
Learning Management System, Drupal can feel less restrictive; Drupal has been 
designed to interact with the Web, and to make the most of the array of possibilities 
offered by the Internet. 

Drupal allows site administrators to set up as closed or as open a site as they desire. 
Using Drupal, a site administrator can create a learning environment where no 
content is visible outside of the site, and where all courses are entirely private. At 
the other end of the spectrum, a site administrator can create a learning environment 
where students and teachers have complete control over the content they share 
with classmates, other site members, and/or the entire Internet community. The 
purpose of this book is not to recommend one approach to teaching and learning 
over another, but rather to highlight the freedom that comes with having choices. In 
this text, we will cover the technical approaches to crafting the ideal social learning 
environment for your specific goals. 


What This Book Covers 

Chapter 1: Introduction provides an overview of Drupal, including a brief section on 
Drupal terminology. 

Chapter 2: Installing Drupal covers how to install Drupal. This chapter takes you 
through the installation process, and covers how to enable some of the core modules 
you will use in this book. 
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Preface 


Chapter 3: Getting Started begins by going through the options enabled in the core 
installation. From there, you will learn how to install additional modules and 
themes. Using these instructions, you will then install and configure two 
commonly-used modules: the Content Construction Kit (also referred to as CCK) 
and views. This chapter includes detailed instructions for creating new content 
types, adding fields to those content types, and displaying content using views. The 
foundation provided in this chapter is referenced extensively throughout the rest 
of the book. 

Chapter 4: Creating a Teacher Blog describes how to set up a blog. This chapter includes 
instructions for setting up a text editor (also known as a WYSIWYG editor), and 
instructions for adding two new content types: one for blog posts, and a second 
for assignments. The chapter continues by covering how to create custom views to 
display content, and closes by showing how to clone an existing view to create a 
calendar to display assignments. 

Chapter 5: Enrolling Students covers how to add users to your site. This chapter 
provides details on creating roles, and using roles to create granular permissions for 
the people who will use your site. 

Chapter 6: Creating the Student Blog includes more details on using roles effectively 
to structure your site. Additionally in this chapter, more advanced techniques with 
views are covered, as we begin to use views to track student and teacher blog posts. 

Chapter 7: Bookmarks describes some of the uses in the classroom of social 
bookmarking. In Chapter 3, we created a content type for storing and categorizing 
bookmarks, and this chapter goes through various methods of using bookmarks to 
support student learning. 

Chapter 8: Podcasting and Images covers how to use your site to publish audio and 
images. In addition to covering the technical details of publishing a podcast, this 
chapter covers various uses of audio in the classroom. In particular, the chapter 
focuses on skills that can be honed through creating podcasts. 

Chapter 9: Video describes how to embed media that is shared on the Web. As part 
of this chapter, we examine how to integrate video production into a curricula, and 
how video production can relate to other types of content stored on the site. As 
with podcasts, the emphasis in this chapter is on what can be learned through video 
production, and on how to use the medium of video effectively. 

Chapter 10: Forums and Blogs describes how to set up and configure forums in Drupal. 
The chapter also explains the similarities and differences between forums and blogs. 
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Preface 


Chapter 11: Social Networks and Extending the User Profile gives an overview of building 
user profiles. The chapter begins with the core profile module, and then goes deeper 
to show how to extend user profiles using the flexible Content Construction Kit and 
custom fields. 

Chapter 12: Supporting Multiple Classes describes how to set up the Organic Groups 
module to support formal and informal learning spaces. The chapter covers using 
different privacy settings, group wikis, email notifications, and varying group types. 

Chapter 13: Tracking Student Progress shows how people can find content created by 
other users within the site. The chapter starts by examining the core Tracker module, 
and then looks at using views and short code snippets to group users and make their 
work easier to find. 

Chapter 14: Theming and User Interface Design provides some introductory details 
of how to create an intuitive navigational structure. The techniques described in 
this chapter are predicated on keeping your site as simple as possible by using 
customized menus. The chapter also introduces Drupal's theming layer, and 
describes how to get started modifying a theme. 

Chapter 15: Backup, Maintenance, and Upgrades gets into one of the most 
commonly-overlooked aspects of running a website: making sure that you have a 
working backup, and keeping your codebase up-to-date. The goal of this chapter 
is to take the sting out of site maintenance. This chapter describes how to use the 
DB Maintenance module to automate the core tasks required for backup, as well as 
backing up using browser-based and command line tools. 

Chapter 16: Working Effectively in the Drupal Community provides an overview of 
how to begin working with the Drupal community. One of the primary benefits of 
working with Drupal is the community of users and developers associated with the 
software. This chapter points out some of the methods of getting involved with and 
contributing back to the project. 


What You Need for This Book 

This book describes how to build websites using Drupal. To use this book effectively, 
you will need Internet access, to be able to download Drupal and the contributed 
modules we describe in this book. 

Additionally, you will need a place to host your website. Setting up a hosting 
environment is covered in Chapter 2: Installing Drupal. 


[3] 


[packtI 

L PUBLISHING J 


This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 





Preface 


Who This Book Is For 

This book is intended for teachers building a website to support their classes, and 
site administrators and technology integrators working within schools or training 
organizations. This book is also intended for technology directors at either the school 
or district level. The examples given in this book are appropriate for students and 
teachers at all levels, from elementary school, through higher education, to adult 
education and vocational training. 

A secondary audience of this book includes people working to deliver curricula 
via online training or blended learning (a combination of online teaching and 
face-to-face meetings), or people interested in using social media in education. This 
text will also be of interest to general web developers looking to learn more about 
configuring Drupal without writing new code. 

By design, this book is not a development manual. This text is intended to support 
people with little to no knowledge of PHP. No knowledge of development in PHP is 
required to use the explanations and tutorials in this text. 


Conventions 

In this book, you will find a number of styles of text that distinguish between 
different kinds of information. Here are some examples of these styles, and an 
explanation of their meaning. 

In this text, the URLs of specific administrative screens are formatted as follows: if 
your site is located at http: //ex a mp I e, edu, the URL of your main administrative 
screen will be at h 11 p: / / e x a mp I e, e d u / a d mi n. In this text, we will just list that URL 
path as a d mi n — it is assumed that you are adding the URL of your site onto the paths 
given in this book. 

A block of code will be set as follows: 
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When we wish to draw your attention to a particular part of a code block, the 
relevant lines or items will be made bold: 

$1 oaded_user = user_l oad(array( 1 uid 1 => $u->ui d)); 

$ Ii n k s[] = I ($1 oaded_user - >name, 'bygroup/'. $1 oaded_user->ui d 
$ gi d ) . $separator . $1 oadeduser - >profi I el astname; 

New terms and important words are introduced in a bold-type font. Words that you 
see on the screen, in menus or dialog boxes for example, appear in our text like this: 
"clicking the Next button moves you to the next screen". Also, in many places, it is 
necessary to describe the location of a specific menu item. On these occasions, you 
will be presented with different methods to get where you need to go. For example, 
to get to the page to administer all content posted on your site, you need to click 
the Administer | Content management | Content menu link, or navigate to 
ent/node. 

Warnings or important notes appear in a box like this. 


Tips and tricks appear like this. 


Reader Feedback 

Feedback from our readers is always welcome. Let us know what you think about 
this book, what you liked or may have disliked. Reader feedback is important for us 
to develop titles that you really get the most out of. 

To send us general feedback, simply drop an email to feedback @p a c k t pub. com, 
making sure that you mention the book title in the subject of your message. 

If there is a book that you need and would like to see us publish, please 
send us a note in the SUGGEST A TITLE form on www, packtpub, com 
or email suggest @packt pub. com. 

If there is a topic that you have expertise in and you are interested in either writing 
or contributing to a book, see our author guide on www, packtpub, com/authors. 


ad mi n/ c o n t 

[•••.: 
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Customer Support 

Now that you are the proud owner of a Packt book, we have a number of things to 
help you to get the most from your purchase. 

Errata 

Although we have taken every care to ensure the accuracy of the content of this 
book, mistakes do happen. If you find a mistake in one of our books — maybe a 
mistake in the text or in the sample code—we would be grateful if you would report 
this to us. By doing this you can save other readers from frustration, and help to 
improve subsequent editions of this book. If you find any errata, please report them 
by visiting http://www.packtpub.com/support, selecting your book, clicking on 
the let us know link, and entering the details of your errata. Once your errata are 
verified, your submission will be accepted and the errata added to any existing 
list of errata. Any existing errata can be viewed by selecting your title from 
http:// www.packtpub.com/support. 

Piracy 

Piracy of copyright material on the Internet is an ongoing problem across all media. 
At Packt, we take the protection of our copyright and licenses very seriously. If 
you come across any illegal copies of our works in any form on the Internet, please 
provide us with the location address or website name immediately, so that we can 
pursue a remedy. 

Please contact usatcopyri ght @packt pub. com with a link to the suspected 
pirated material. 

We appreciate your help in protecting our authors, and our ability to bring you 
valuable content. 

Questions 

You can contact us at q u e s t i ons@packt pub. c o m if you are having a problem with 
any aspect of the book, and we will do our best to address it. 
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Introduction 


Welcome to Using Drupal in Education and E-Learning! 

The last several years have seen an incredible upswing in the popularity and 
adoption of Drupal. The size of the Drupal community, as of May, 2008, is 
approaching 300,000 registered users, and Drupal is used to power everything from 
personal blogs to online stores to learning platforms to sites for record labels. 

This book provides details of how to install Drupal, and how to customize Drupal to 
support teaching and learning. This initial chapter provides a high-level overview of 
Drupal, along with details of how to get the most from this book. 

What is Drupal 

A concise definition of Drupal is difficult to come by, as many people use Drupal for 
many different things. The following definitions provide an incomplete cross-section 
of how different people use Drupal. Our working definition is the final one in the list. 

• Drupal is a database-driven web application written in PHP. 

• Drupal is an open-source Content Management System (CMS) freely 
available under the GPL. 

• Drupal is a community-building platform. 

• Drupal is a web development framework. You can use Drupal as a platform 
to build a broad range of web applications. 
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The above definitions, however, can also benefit from further explanation. 
For those interested in additional reading and background, the following 
links provide a more detailed overview, and some background 
information: 

PHP: http://php.net/ 

Web content management system, defined: http: / / en. Wikipedia, 
org/wi ki / Web_cont ent_management_syst em 

The GPL, or the Gnu Public License: http://www.gnu.org; Drupal 
is covered under version 2 of the GPL: http://www.gnu.org/ 

I i censes/ol d -1 i censes/gpl - 2. 0. html 

Web development framework, defined: http://en.wikipedia.org/ 
wi k i / We b _ a p p I i c a t i o n _ f r a me wo r k 

Background information on Open Source: 
http://www. opensour ce. or g 

Overview section, from the Drupal handbook: http://drupal . o r g / 
node/21951 


Our definition: Drupal is a tool that helps people build interactive websites. It is free 
to download, install, customize, and use. 


Drupal—A Short Historical Overview 

Drupal was started in 2000 by Dries Buytaert when he was a student at the 
University of Antwerp. Dries, along with some friends at the university, wanted a 
way to communicate about the various details of their lives. To meet that need. Dries 
wrote a web-based application that allowed people to share notes. In January 2001, 
Dries decided to release the source code, and the Drupal project was born. 

The Drupal handbook provides a more detailed overview: 
http://drupal.org/node/769 

What Drupal Can Do For You 

Drupal is not a traditional Learning Management System. Drupal started as a 
community-building platform, and these community-centered roots inform the range 
of possibilities available within Drupal today. 

Drupal provides a wide variety of useful tools for educators. For the instructor, 
Drupal can serve as a blogging platform, allowing teachers to communicate directly 
with students, parents, and the larger school and internet community. 
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Drupal also offers a flexible range of privacy options that allow users to keep 
some — or all — of the content within a site private. However, a Drupal site can be 
used for far more than a secure blogging platform. Within a single Drupal site, you 
can set up social bookmarking, podcasting, video hosting, formal and informal 
groups, rich user profiles, and other features commonly associated with Social 
Web Communities. Building your site in Drupal allows you to start with precisely 
the features you want, and expand as needed. This book provides the information 
needed to build, maintain, and grow your site. 

Drupal Terminology 

Drupal, like most software applications, has a specific lexicon. Mastering Drupal 
jargon is useful for many reasons, not the least of which is that using Drupal-specific 
terminology can help you search for information more effectively. The glossary in 
this chapter will give you an overview of commonly used Drupal terms, and what 
they mean. 

This list of terminology will cover our common tasks and features. For a glossary 
that delves into some of the technical aspects of Drupal, the Glossary page in the 
Drupal handbook is a useful resource: http://drupal.org/node/937. 

Node: A node is a piece of content that has been created on your site. For example, if 
you create a page, you have created a node. 

Content Type or Node Type: On your Drupal site, you will have different types of 
nodes, or content. The default install comes with two content types. Page and Story. 
As we progress through this book, we will create a variety of other node types, such 
as bookmarks, student blogs, audio nodes, and so on. While all types of nodes are 
content, different node types can have different functions on your site. 

Post: A post is a piece of content of any content type. For example, if a user creates a 
page node, they have created a post. 

Core: Core refers to the base install of Drupal. The core install consists of the 
essential modules and some basic themes for Drupal. Although any person who has 
an account on d r u p a I . o r g can suggest a change to the core codebase, most changes 
to core are thoroughly reviewed by developers within the community, and only a 
small number of people have the rights to actually make changes to core. As a result, 
the core codebase is stable and secure. The core codebase can be downloaded from 
http://drupal . org/proj ect/drupal . 
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Contributed Modules: These have been written and shared by members of the 
Drupal community. Unlike core, which represents the work of several hundred 
contributors, most contributed modules have been written by individuals, or small 
teams working together. Contributed modules extend the functionality of Drupal, 
and this book describes how to use various contributed modules effectively. 
However, you should be cautious when installing a new contributed module. 
Contributed modules have not been reviewed as thoroughly as core. An overview of 
all contributed modules is available at http://drupal.org/project /Modules. 

Theme: Themes control the look and feel of your site. The core install comes with 
several base themes, and you can download a range of contributed themes from 
http://drupal . org/proj ect/themes. 

Menu: Menus provide lists of links, and can be used to create an organizational 
and navigational structure for your site. All menus can be seen and edited at 
ad mi n/bui I d/menu; additionally, all menus create blocks. 

Block: A block displays content within a specific place on the page. All menus create 
blocks, but you can also embed HTML or PHP code within a block. Blocks can be 
administered at a d mi n/bui I d / b I o c k. 

Region: Every theme defines specific regions; blocks can be placed into these 
different regions using the administrative menu at ad mi n/bui I d/bl ock. 

Menus, Blocks, and Regions are covered in Chapter 14: Theming and User 
Interface Design. 

Taxonomy: Taxonomy can be used to organize content within a Drupal site. Drupal 
permits site administrators to create different taxonomy categories to organize 
posts. For example, when posting an assignment, an instructor might want to create 
two taxonomies: one for the type of assignment, and another for the subject of 
the assignment. 

Term: Terms, or tags, are specific items within a taxonomy. For example: a Physics 
instructor creates two taxonomies to organize assignments. The first is 'Type of 
Assignment' and the second is ’Subject'. If the instructor assigns his or her students to 
read an explanation of the Theory of Relativity, this assignment could be tagged with 
Reading (for Type of Assignment) and Relativity (for Subject). 

User: This is the technical term for people using your site. 

Role: All site users belong to one or more roles. Site administrators can assign 
different rights to different roles. 
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Anonymous user: Any person who visits your site and is not a member of your site 
is considered an anonymous user. The Anonymous user role allows you to specify 
how people who are not site members can interact with content and members of 
your site. 

It is possible to remove all rights from anonymous users, making the 
content of your site fully private, or a 'walled garden 1 . 

Authenticated user: All site members are authenticated users, and belong to the 
default authenticated user role. This default role can be used to assign a base level 
of rights to all site members. Then, other roles can be used to assign more advanced 
privileges to users. 

Roles and access control are covered in more detail in Chapter 5: 

Enrolling Students. 

UID1: This stands for User ID 1, or the first user on a Drupal site. UID1, by design, 
has full rights over your entire site. As a matter of best practice and security, UID1 
should only be used as a back-up administrator account. Often, problems with your 
configuration will not be visible when logged in as UID1 because UID1 has more 
rights than other users. 

Taking Notes 

A final piece of advice before we launch into building your Drupal site: buy a 
notebook, and keep it next to your computer. Use this notebook in the same way a 
ship's captain uses her log: take brief notes on what you do, and why. 

In the process of building your site, you will make decisions about module 
configurations, user roles, design tweaks, and so on. As you are making these 
decisions, you will be fully convinced that you will remember each decision you 
made, and why. 

Unless you are the exception that proves the rule, however, you won't remember. 
And this is where your notebook comes in. Use the notebook to record the changes 
you make. A useful entry will include the URL where you made the change, and a 
brief description of why you made the change. 

For example, if I am adjusting user privileges for the authenticated user role, I would 
enter the following in my notes: 

Afadmi n/ user / access / 2 - adjust user privileges so that the authenticated user 
role needs to have comments approved. 
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This way, when you are trying to remember why you made a specific change, you 
will have a record of your decision making process. 

Summary 

This chapter provided an overview of Drupal, and of the functionality you will be 
able to include on your site. Now that we have covered the general details, it's time 
to begin working directly with the software. In the next two chapters, we will 
install Drupal, and start exploring the core functionality you will use to build your 
learning community. 

So, keep your notebook handy, and let's start building your site! 
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Installing Drupal 

This chapter describes how to install the base Drupal application, called Drupal 
core. By the end of this chapter, you will have a new Drupal site installed and ready 
to use. 


Assumptions 

To get Drupal up and running, you will need all of the following: 

• A domain 

• A web host 

• FTP access to your web host 

OR 

• A local testing environment 

For building sites, either a web host or a local testing environment will meet your 
needs. A site built on a web-accessible domain can be shared via the internet, 
whereas sites built on local test machines will need to be moved to a web host before 
they can be used for your course. The process of backing up and moving sites is 
covered in Chapter 15: Backup, Maintenance, and Upgrades. 

In these instructions, we are assuming the use of phpMyAdmin, an 
open-source, browser-based tool, for administering your database. A 
broad range of similar tools exist, and these general instructions can 
be used with most of these other tools. Information on phpMyAdmin 
is available at http:// www. phpmyadmi n, net; information on other 
browser-based database administration tools can be found at 
h 11 p: / / d e v. mysql . com/downl oads/gui - tool si . 
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The Domain 

The domain is the address on the Web at which people can access your site. If you 
are building this site as part of your work, you will probably be using the domain 
associated with your school or organization. If you are hosting this on your own 
server, you can buy a domain for under US $10.00 a year. Enter purchase domain 
name into Google, and you will have a plethora of options. 

The Web Host 

Your web host provides you with the server space on which to run your site. Within 
many schools, your website will be hosted by your school. In other environments, 
you might need to arrange for your own web host by using a hosting company. 

In selecting a web host, you need to be sure that they run software that meets or 
exceeds the recommended software versions. 

Web Server 

Drupal is developed and tested extensively in an Apache environment. Drupal also 
runs on other web servers, including Microsoft IIS. 


PHP version 

Drupal 6 will run on PHP 4.3.5; however, many contributed modules require 
PHP 5.2. For this reason, PHP 5.2 is recommended. The Drupal 7 release will 
require PHP 5.2. 

MySQL version 

Drupal 6 will run on MySQL 4.1 or higher; 5 is recommended. The Drupal 7 release 
will require MySQL 5.0. 


FTP and Shell Access to Your Web Host 

Your web host should also offer FTP access to your web server. You will need FTP 
(or SFTP) access in order to upload the Drupal codebase to your web space. Shell 
access, or SSH access is not essential for basic site maintenance. However, SSH access 
can simplify maintaining your site, so contracting with a web host that provides 
SSH access is recommended. 
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A Local Testing Environment 

Alternatively, you can set up a local testing environment for your site. This allows 
you to set up Drupal and other applications on your computer. A local testing 
environment can be a great tool for learning a piece of software. Fortunately, 
open-source tools can automate the process of setting up your testing environment. 

PC users can use XAMPP (http:// www. a p a c h e f r i ends, o r g ) to set up a local testing 
environment; Mac users can use MAMP (http:// www, ma mp, i n f o). 

If you are working in a local testing environment set up via XAMPP or MAMP, you 
have all the pieces you need to start working with Drupal: your domain, your web 
host, the ability to move files into your web directory, and PHPMyAdmin. 

The Most Effective Way versus 
The Easy Way 

There are many different ways to install Drupal. People familiar with working via 
the command line can install Drupal very quickly without an FTP client or any 
web-based tools to create and administer databases. The instructions in this book 
are geared towards people who would rather not use the command line. These 
instructions attempt to get you through the technical pieces as painlessly as possible, 
to speed up the process of building a site that supports teaching and learning. 

Installing Drupal—The Quick Version 

The following steps will get you up and running with your Drupal site. This 
quickstart version gives an overview of the steps required for most setups. A more 
detailed version follows immediately after this section. 

Once you are familiar with the setup process, installing a Drupal site takes between 
5 and 10 minutes. 

1. Download the core Drupal codebase from 
http://drupal.org/project/drupal. 

2. Extract the codebase on your local machine. 

3. In your extracted codebase, navigate to the sites/default directory. This 
directory contains one file: defaul t, setti ngs, php. Make a copy of this file, 
and name the copy setti ngs. php. 

4. Using phpMyAdmin, create a database on your server. Write down the name 
of the database. 
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5. Using phpMyAdmin, create a user on the database using the following 
SQL statement: 

GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, 

ON databasename. * 

TO ' username' I ocal host' IDENTIFIED BY 'password'; 

You will have created the databasename in Step 4; write down the username 
and password values, as you will need them to complete the install. 

6. Upload the Drupal codebase to your web folder. 

7. Navigate to the URL of your site. Follow the instructions of the Install 
Wizard. You will need your databasename (created in Step 4), as well as the 
username and password for your database user (created in Step 5). 

Installing Drupal—The Detailed Version 

This version goes over each step in more detail, and includes screenshots. 

Getting the Codebase 

1. Download the core Drupal codebase from 
http://drupal . o r g/ proj ect/drupal . 


Home » Download 

Drupal project 


j Documentation | Download | Support j Forum | Contribute | Contact 


]] [ Search ] 


C 


Filter by Drupal Core compatibility: | <all> ~| Login or register to modify the filter. 

Get started by downloading the official Drupal core files. These official releases come bundled with a variety of modules 
and themes to give you a good starting point to help build your site. Drupal core includes basic community features like 
blogging, forums, and contact forms, and can be easily extended by downloading other contributed modules and 
themes. 

Drupal 

Drupal is an open-source platform and content management system for building dynamic web sites offering a 
broad range of features and services including user administration, publishing workflow, discussion capabilities, 
news aggregation, metadata functionalities using controlled vocabularies and XML publishing for content sharing 
purposes. Equipped with a powerful blend of features and configurability, Drupal can support a diverse range of 
web projects ranging from personal weblogs to large community-driven sites. 

Note: Drupal works with PHP 4 & 5. If you need support for the newest PHP 5.2, however, you 
must use Drupal 6.0 (and higher) or Drupal 5.1 (and higher) 

If you are using Internet Explorer and WinZip, save the file first, as otherwise IE will corrupt the file's extension. 
Information on version numbers and System Requirements can be found in the handbook. 


Version 

Date 

Links 

Status 


7.x-dev 

2008-Mar-21 

Download - Release notes 

Development 

snapshot 

Q 

6.1 

2008-Feb-27 

Download • Release notes 

Recommended for 

6.x 

✓ 

5.7 

2008-Jan-29 

Download ■ Release notes 

Recommended for 

5.x 

✓ 



Find out more 

Bugs and feature requests 


Username: * 

[bonobo 


[ Log ir 


• Create new account 
> Request new password 
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2. Extract the codebase on your local machine. 


The Drupal codebase (and all modules and themes) are compressed into 
a tarball, or a file that is first tarred, and then gzipped. Such compressed 
files end in , tar, g z. 

On Macs and Linux machines, tar. g Z files can be extracted 
automatically using tools that come preinstalled with the operating 
system. On PC's, you can use 7-zip, an open-source compression utility 
available at http://www. 7-zip. org. 

3. In your extracted codebase, navigate to the sites/default directory. This 
directory contains one file: defaul t, setti ngs, php. 



Make a copy of this file, and name the copy setti ngs, php, 

Creating the Database and the Database User 

4. In your web browser, navigate to where PHPMyAdmin is installed on your 
web server. If you are using a different tool for creating and managing your 
database, use that tool to create your database, and database user. 

5. As shown in the following screenshot, create the database on your server. 
Click the Create button to create your database. 

Store your database name in a safe place. You will need to know your 
database name to complete your installation. 
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p/j pMtjAdmln 
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£3 Server version: 5.0.27-standard ► MySQL client version: 5.0.27 

► Protocol version: 10 ► Used PHP extensions: mysql 

Si Server: Localhost via UNIX socket f Language © : English v 

Database 

(Databases) 

Please select a database 

2- 

► User: root@localhost Theme / Style: Original 

H MySQL charset: UTF-8 Unicode (utf8) 

mn I. o/">i ^ ii * ► Font size: 100% v 

Lai MySQL connection collation: L 1 

utf8_unicode_d v a £? phpMyAdmin documentation 

& Create new database a a O" 103 ' PhpMyAdmin Homepage 

™^^idrupal6 utf8_general_d v > [ChangeLog] [CVS] [Lists] 

| Create | 


6. To create your database user, click the SQL tab as shown in the following 
screenshot. In the text area, enter the following SQL statement: 

GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, 

ALTER, ON dat abasename. * 

TO 'username 1 ® 1 local host' IDENTIFIED BY 'password'; 

7. For databasename, use the name of the database you created in Step 4. 
Replace the username and password with a username and password of 
your choice. Once you have entered the correct values, click the Go button to 
create the user with rights on your database. 



[18] 


[packtI 

L PUBLISHING J 


This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 













































Chapter 2 


Store the username and the password of your database user in a safe 
place. You will need them to complete the installation. 


Completing the Install 

8. Create and/or locate the directory from where you want Drupal to run. In 
this example, we are running Drupal from within a folder named drupal 6; 
this means that our site will be available at http: / /ourdomai n. o r g / 
drupal 6. 

9. Using your FTP client, upload the Drupal codebase to your web folder. 
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10. Navigate to the URL of your site. The automatic install wizard will appear on 
your screen. 



11. Click the Install Drupal in English link as shown in the preceding 
screenshot. As soon as you click this link, the installer will verify that your 
web host meets the requirements to run Drupal. 

12. To complete the Set up database screen, you will need the database name 
(created in Step 4) and the database username and password (created in 
Step 6). Select mysqli as the Database type and then enter these values in 
their respective text boxes as seen in the following screenshot: 
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13. Most installs will not need to use any of settings under Advanced options. 
However, if your database is located on a server other than localhost you 
will need to adjust the settings as shown in the next screenshot. 



In most basic hosting setups, your database is accessible at localhost. 

To verify the name or location of your Database host, you can use 
php My Admin (as shown in the screenshot under the section Creating the 
Database and the Database User ) or contact an administrator for your web 
server. For the vast majority of installs, none of the Advanced options 
will need to be adjusted. 
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Installing Drupal 


14. Click the Save and continue button. You will see a progress meter as Drupal 
installs itself on your web server. 


Drupal 


Choose language 
y/ Verify requirements 

✓ Set up database 

✓ Install site 

► Configure site 

Finished 


Configure site 

All necessary changes to ./sites/default and ./sites/default/settings.php have 
been made. They have been set to read-only for security. 

To configure your website, please provide the following information. 

Site information 


Site name: 


Site e-mail address: 


The From address in automated e-mails sent during registration and new password 
requests, and other notifications. (Use an address ending in your site's domain to 
help prevent this e-mail being flagged as spam.) 


Administrator account 

The administrator account has complete access to the site; it will automatically be 
granted all permissions and can perform any administrative activity. This will be the 
only account that can perform certain activities, so keep its credentials safe. 

Username: ' 


Spaces are allowed; punctuation is not allowed except for periods, hyphens, and 
underscores. 

E-mail address: 

All e-mails from the system will be sent to this address. The e-mail address is not 
made public and will only be used if you wish to receive a new password or wish to 
receive certain news or notifications by e-mail. 

Password: ' 


Confirm password: 


Server settings 

Default time zone: 

| Sunday, March 23, 2008 - 14:06 -0700 iyj| 

By default, dates in this site will be displayed in the chosen time zone. 

Clean URLs: 

O Disabled 
® Enabled 

This option makes Drupal emit "dean" URLs (i.e. without in the URL). 
Your server has been successfully tested to support this feature. 


Update notifications: 

0 Check for updates automatically 

With this option enabled, Drupal will notify you when new releases are available. This 
will significantly enhance your site's security and is highly recommended. This requires 
your site to periodically send anonymous information on its installed components to 
drupal.org. For more information please see the update notification information. 

[ Save and continue"] 
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Chapter 2 


15. On the Configure site screen, you can enter some general information 
about your site, and create the first user account. The first user account has 
full rights over every aspect of your site. When you have finished with the 
settings on this page, click the Save and continue button. 

16. When the install is finished, you will see the following splash screen: 


Packt and Drupal 



. Drupal installation complete 

y/ Choose language 


Congratulations, Drupal has been successfully installed. 


✓ Verify requirements 

You may now visit lyour new sSd. 

✓ Set up database 

✓ Install site 

✓ Configure site 
>/ Finished 


Additional details on installing Drupal are available in the handbook at 
http://drupal. org/getti ng-started/6/i nstal I . 

Enabling Core Modules 

In Chapter 3: Getting Started, we will look at the functionality of Core Drupal. In 
preparation for that section, we will look at the modules that come with core Drupal, 
and enable some of them. 

For a full description of the modules included in Drupal core, see 
http://drupal . org / handbook / modul es. 


[ 23 ] 


[packt] 

L PUBLISHING J 


This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 









Installing Drupal 


To see the modules included in Drupal core, navigate to Administer | Site building 
| Modules, or a d mi n / b u i I d / mo d u I e s. 


Core - optional 


Enabled 

Name 

Version 

Description 

□ 

Aggregator 

6.6 

Aggregates syndicated content (RSS, RDF, and Atom feeds). 

□ 

Blog 

6.6 

Enables keeping easily and regularly updated user web pages or blogs. 

□ 

Blog API 

6.6 

Allows users to post content using applications that support XML-RPC blog 
APIs. 

□ 

Book 

6.6 

Allows users to structure site pages in a hierarchy or outline. 

0 

Color 

6.6 

Allows the user to change the color scheme of certain themes. 

0 

Comment 

6.6 

Allows users to comment on and discuss published content. 

Required by: Forum (disabled). Tracker (disabled) 

□ 

Contact 

6.6 

Enables the use of both personal and site-wide contact forms. 

□ 

Content 

6.6 

Allows content to be translated into different languages. 

translation 

Depends on: Locale (disabled) 

0 

Database 

logging 

6.6 

Logs and records system events to the database. 

□ 

Forum 

6.6 

Enables threaded discussions about general topics. 

Depends on: Taxonomy (enabled). Comment (enabled) 

0 

Help 

6.6 

Manages the display of online help. 




Adds language handling functionality and enables the translation of the 

□ 

Locale 

6.6 

user interface to languages other than English. 

Required by: Content translation (disabled) 

0 

Menu 

6.6 

Allows administrators to customize the site navigation menu. 

□ 

OpenID 

6.6 

Allows users to log into your site using OpenID. 

□ 

Path 

6.6 

Allows users to rename URLs. 

□ 

PHP filter 

6.6 

Allows embedded PHP code/snippets to be evaluated. 

□ 

Ping 

6.6 

Alerts other sites when your site has been updated. 

□ 

Poll 

6.6 

Allows your site to capture votes on different topics in the form of 
multiple choice questions. 

0 

Profile 

6.6 

Supports configurable user profiles. 

0 

Search 

6.6 

Enables site-wide keyword searching. 

0 

Statistics 

6.6 

Logs access statistics for your site. 

0 

Syslog 

6.6 

Logs and records system events to syslog. 

0 



Enables the categorization of content. 

Taxonomy 

6.6 

Required by: Forum (disabled), Simplenews (disabled), Simplenews action 
(disabled) 


□ 

Throttle 

6.6 

Handles the auto-throttling mechanism, to control site congestion. 

0 

Tracker 

6.6 

Enables tracking of recent posts for users. 

Depends on: Comment (enabled) 




Enables actions to be fired on certain system events, such as when new 

□ 

Trigger 

6.6 

content is created. 

Required by: Simplenevs action (disabled) 

0 

Update 

status 

6.6 

Checks the status of available updates for Drupal and your installed 
modules and themes. 

0 

Upload 

6.6 

Allows users to upload and attach files to content. 
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Chapter 2 


As shown in the preceding screenshot, enable the following core modules: 

Color, Comment, Database logging. Help, Menu, Profile, Search, Statistics, Syslog, 
Taxonomy, Tracker, Update status, and Upload. 

Once the modules have been selected, click the Save configuration button at the 
bottom of the page to save the changes. 

Assigning Rights to the Authenticated 
User Role 

Within your Drupal site, you can use roles to assign specific permissions to groups of 
users. As described in the brief glossary in Chapter 1, Drupal comes with two default 
roles: the anonymous user and the authenticated user. Anonymous users are all 
people visiting the site who are not site members; all site members (that is, all people 
with a username and password) belong to the authenticated user role. 

[ , - Creating additional roles is covered in Chapter 3: Getting Started; T 

\%\ assigning granular rights to users via roles is discussed in more detail in I 
Chapter 5: Enrolling Students. f 

To assign rights to specific roles, navigate to Administer | User management | 

Roles, oradmi n / user / rol es. 
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Installing Drupal 


As shown in the above screenshot, click the edit permissions link for 
authenticated users. 

Assign authenticated users the following rights: 

• Comment module: Authenticated users can see comments, and post 
comments. These rights have the comments going into a moderation 
queue for approval, as we haven't checked the post comments without 
approval box. 


comment module 

access comments 

0 

administer comments 

□ 

post comments 

0 

post comments without approval 

□ 


• Node module: Authenticated users can see content 


node module 


access content 

0 


• Search module: Authenticated users can search the site 


search module 

administer search 

□ 

search content 

0 

use advanced search 

0 
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• User module: Authenticated users can change their username 


user module 

access user profiles 

□ 

administer permissions 

□ 

administer users 

□ 

change own username 

0 


Once these options have been selected, click the Save Permissions button at the 
bottom of the page. 

Summary 

In this chapter, we installed the core Drupal codebase, enabled some core modules, 
and assigned rights to the authenticated user role. We are now ready to start 
building a feature-rich site that will help support teaching and learning. In the next 
chapter, we will take a look around your new site and begin to get familiar with how 
to make your site do what you want. 
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Getting Started 

Now that you have installed your Drupal site, we need to take a look around and see 
exactly what we have at our disposal. The default Drupal install is fairly minimalist, 
and this base install will be modified extensively as we progress through this book. 

This chapter will cover the features enabled when the site is installed, and the 
Drupal-specific terminology used to describe those features. 


The Core Install 

The core Drupal install is a blank slate. Although the core install contains the 
potential to become a powerful, flexible learning tool, much of this functionality 
needs to be enabled and configured. 

However, before we begin extending the features and functionality of your site, we 
will look at the functionality of the core Drupal install, and how the administrative 
sections are organized. The core install provides the foundation on which we will 
build your site. 
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The default navigation menu seen in the preceding screenshot shows the options 
available in the core Drupal install. In this explanation, we will break them down 
into Core User Functionality, and Administrative Functionality. 

Core User Functionality 

The options enabled in the default Drupal install provide a starting point for creating 
your site. We will add to these options; however, before we begin making changes to 
the site we will run through some of the features enabled by default. 

My Account 

The My account page, shown in the following screenshot, shows your user profile. 
All users have a profile page. 
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The Edit tab allows users (or site administrators) to edit their profile information. 
Chapter IV. Social Networks and Extending the User Profile, goes into more detail on 
how to extend user profiles to introduce some of the common features of social 
networking sites. 
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Getting Started 


Create Content 

The items in the Create content sub-menu, allows you to add content to your site. To 
see the full list of content types that can be created, click the Create content link, or 
navigate tonode/add. 


n " ~ ' - =1 

y 


^4 Packt and Drupal 

'—' 



Home 

bill 

Create content 

0 My account 

Page 

v Create content 

A page, similar in form to a story, is a simple method for creating and displaying information that 

° Page 

rarely changes, such as an "About us" section of a website. By default, a page entry does not 
allow visitor comments and is not featured on the site's initial home page. 

° Story 

Story 

0 Administer 

A story, similar in form to a page, is ideal for creating and displaying content that informs or 

° Log out 

engages website visitors. Press releases, site announcements, and informal blog-like entries may 
all be created with a story entry. By default, a story entry is automatically featured on the site's 
initial home page, and provides the ability to post comments. 


r?PB»nnTfttl 


In the core install, two content types are enabled by default: Page and Story. Pages 
and stories provide two ways of adding content to your site. Functionally, they are 
interchangeable; however, because they are different content types you can configure 
them differently, and assign different access rights to them. For example, you can 
give one set of users the right to create pages, and another set of users the right to 
create stories. 

Log Out 

The Log out link logs you out of the site. 

Administrative Functionality 

You can see the Administer screen by clicking the Administer link in the navigation 
block, or by navigating to a d mi n. 

The administrative functionality is broken into five sections: 

1. Content management 

2. Site building 
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3. Site configuration 

4. User management 

5. Reports 

The administrative section also includes a brief Help section, accessible by clicking 
the Administer | Help link, or by navigating to a d mi n / h e I p . The help texts in this 
section provide an overview of the modules and functionality within your site, and 
link to any relevant handbook pages. 

Content Management 

The Content management administrative section is accessed by clicking the 
Administer | Content Management link, or by navigating to ad mi n/content. 

The administrative features of this section provide a set of tools for managing 
content on your site. 
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Using the options on this admin page, you can manage different aspects of the 
content published on your site. One option here that bears some additional 
examination is the Content types page. This is accessible at ad mi n/content/types, 
and can be seen in the following screenshot: 



This page includes the option for adding additional content types. The options on 
this page will be used extensively in this book, starting later in this chapter. 
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Site Building 

The Site building administrative section is accessed by clicking the 
Administer | Site building link, or by navigating to a d mi n / b u i I d. 

The administrative features of this section allow you to add additional functionality 
and structure to your site. The Menu and Block sections, described in more detail 
in Chapter 14: Theming and User Interface Design, allow you to create a flexible 
navigational structure tailored to specific roles within your site. 



Additionally, the Modules page gives an overview of all modules installed and 
enabled on your site. Whenever you need to enable or disable a module, you will 
need to go to the modules page at a d mi n / b u i I d / mo d u I e s. 
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Site Configuration 

The Site configuration administrative section is accessed by clicking the 
Administer | Site configuration, or ad mi n/setti ngs. 

The administrative features of this section allow you to fine-tune various features 
of the site. In most cases, the default values will work perfectly well. In subsequent 
chapters, we will adjust the settings in this section to fine-tune the functionality to 
run your site. 
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User Management 

The User management administrative section is accessed by clicking the 
Administer | User management link, or by navigating to a d mi n / u s e r . 

The administrative features of this section let you add roles, assign rights to those 
roles, extend user profiles, and control how people can join the site. 



The details of user management are covered in more detail in 
Chapter 5: Enrolling Students. 

Reports 

The Reports administrative section is accessed by clicking the 
Administer | Reports link, or navigating to a d mi n/reports. 

The options in this section provide different report logs of activity on your site. 
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The information logged in this section gives you an overview of how your site is 
running. In particular, the Available updates section at ad mi n/reports/updates 
(covered in more detail in Chapter 15: Backup, Maintenance, and Upgrades) gives you 
an at-a-glance overview of any modules in need of upgrading. 


Home > Administer > Reports 

Status report 

Here you can find a short overview of your site’s parameters as well as any problems detected with your installation. It 
may be useful to copy and paste this information into support requests filed on drupal.org's support forums and project 
issue queues. 


Drupal 

6.3 

y/ Access to update.php 

Protected 

y/ Configuration file 

Protected 

y/ Cron maintenance tasks 

Last run 34 min 52 sec ago 

You can run cron manually. 


y/ Database updates 

Up to date 

\/ Drupal core update status 

Up to date 

y/ File system 

Writable {public download method) 

y/ GD library 

bundled (2.0.28 compatible) 

y/ Module and theme update status 

Up to date 

y/ MySQL database 

5.0.27 

y/ PHP 

5.2.1 

y/ PHP memory limit 

64M 

>/ PHP register globals 

Disabled 

y/ Unicode library 

PHP Mbstring Extension 

y/ Update notifications 

Enabled 

✓ Web server 

Apache/2.0.52 (Red Hat) 


The Status report admin screen at ad mi n/reports/status, as shown in the 
preceding screenshot, gives you useful technical information about your Drupal 
codebase and the hosting environment. Frequently, when troubleshooting issues 
with your site, the information from this page can be invaluable. For the technically 
inclined, the version numbers next to PHP and MySQL database link to pages that 
give you an overview of how PHP and MySQL are configured. 
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Next Steps: Building the Foundation 

Now that we have examined the core Drupal install and its default settings, we are 
ready to begin building out additional functionality. The rest of this chapter covers 
the steps you will be using repeatedly as you design your site. Although some details 
will vary depending on the context, the details in this chapter will provide a point of 
reference as you build out your site. 

The elements of this foundation include: 

• Installing modules and themes 

• Adding roles 

• Creating content types 

• Creating views 

Installing Modules and Themes 

As you run and administer your Drupal site, you will need to install and enable 
different contributed modules and themes. To understand how to install contributed 
modules and themes, we will need to take a brief look at Drupal's directory structure 
as pictured in the following screenshot: 


Remote site: | /var/www/html/drupal6 

□ fcD drupal6 

indudes 
Mffo misc 
a modules 
(±H£j) profiles 
l-a scripts 
SI IS) sites 
a themes 


Filename / 

Rlesize 

Rletype 

Last modified 

Permissions 

Owner / Group 

1^1 indudes 


Rle Folder 

7/6/2008 11:09... 

drwxr-xr-x 

vuser 

(remise 


Rle Folder 

7/6/2008 11:09... 

drwxr-xr-x 

vuser 



Rle Folder 

7/6/2008 11:1L.. 

drwxr-xr-x 

vuser 

(^profiles 


Rle Folder 

7/6/2008 11:11... 

drwxr-xr-x 

vuser 

|jj| scripts 


Rle Folder 

7/6/2008 11:11... 

drwxr-xr-x 

vuser 

ICH sites 


Rle Folder 

7/6/2008 11:11... 

drwxr-xr-x 

vuser 

Il 3 themes ■ 


File Folder 

7/6/2008 11:15... 

drwxr-xr-x 

vuser 

|E?J| .htaccess 

3,488 

HTACCESS .. 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

GO CHANGELOG.txt 

37,150 

Text Docu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

© COPYRIGHT.txt 

981 

TextDocu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

1^1 cron new.php 

262 

PHP Rle 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

index, php 

980 

PHP Rle 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

© INSTALL.mysql.txt 

1,308 

Text Docu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

0 INSTALL.pgsql.txt 

1,075 

TextDocu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

1^1 install, php 

45,837 

PHP Rle 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

© INSTALL.txt 

14,744 

TextDocu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

© LICENSE.txt 

18,064 

TextDocu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

© MAINTAINERS.txt 

1,978 

Text Docu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

© robots.txt 

1,627 

TextDocu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

[^update, php 

25,244 

PHP Rle 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

© UPGRADE.txt 

5,002 

TextDocu... 

7/6/2008 11:09... 

-rw-r-r— 

vuser 

|sQ xmlrpc.php 

352 

PHP Rle 

7/6/2008 11:09... 

-rw-r-r— 

vuser 


15 files and 7 directories. Total size: 158,092 bytes 
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As seen in the preceding screenshot, the directory structure contains seven 
directories, in addition to 15 files in the base folder of the Drupal install. 

Files 

On looking at the files in the base folder of the Drupal install, we will see three 
different types of files: an , h t a c c e s s file, a series of , t x t files, and a series of , p h p 
files. The , h t a c c e s s file contains specific settings that help ensure that your site 
runs smoothly; the , t x t files (with the exception of r o b o t s , t x t ) all contain 
information about Drupal, and the , p h p files are all part of the codebase that 
allows your site to run. 

For most sites, you will never need to open or edit any of these files. Of all the files 
in the base directory of your Drupal install, the only two that could ever require 
editing are the , h t a c c e s s file and the robots, t x t files. However, tweaks to these 
files should only be done when absolutely necessary and you should always back up 
these files before attempting any modifications to them. 

Directories 

On looking at the directories of the Drupal install, we will focus on three directories: 
modules, themes, and sites. 

Core Modules and Themes 

The modules and themes directories of the core Drupal install, indicated by the 
dashed arrows in the preceding screenshot, contain the core modules and themes. 

[ -Hy t Under no circumstances should anything ever be added into these 
directories. 

The Sites Directory 

The sites directory, indicated by the solid arrow in the preceding screenshot, 
contains the directories into which we install additional modules and themes. The 
default Drupal installation, as shown in the following screenshot, comes with two 
sub-folders in the sites directory: all and default. 

The default directory contains our setti ngs, php file; the all directory is where we 
will put contributed themes and modules. 
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To start, we need to create themes and modules directories in si t e s / a I I , as 
pictured in the following screenshot: 



In many FTP clients, you can create new folders by using the context 
menu that appears when you right-click within the parent directory. 

Once you have created these folders, you are ready to install modules and themes. 

Adding Modules and Themes: The Steps 

To add a module or a theme, follow these four steps: 

1. Download the theme or module from d r u p a I , o r g. 

2. Decompress the theme or module. They are packaged on drupal.org as 
tar. g z files, and need to be extracted before they can be installed. 

3. Upload the theme or module to your site. 

4. Enable the modules at a d mi n / b u i 1 d / mo d u I e s or the theme at 
a d mi n / b u i I d /1 h e me s . 
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Step 1: Download 

All modules and themes are downloaded from their project page. In this example, 
we will download and install the Views module and the Advanced Help module. To 
get the source code, we will navigate to the Views project page at h 11 p: / / d r u p a I . 
org/project/views as shown in the following screenshot, and also the Advanced 
help project page at http://drupal.org/project/advanced_help. 


Home » Download * Modules 

Views ___ 

_| View | [ Edit ] [ Outline ] f~~Revisions~] f CVS access") _ 

merlinofchaos - November 25, 2005 - 12:34 Content display • Views • Modules 

The views module provides a flexible method for Drupal site designers to control how lists of content (nodes) are presented. 
Traditionally, Drupal has hard-coded most of this, particularly in how taxonomy and tracker lists are formatted. 

This tool is essentially a smart query builder that, given enough information, can build the proper query, execute it, and display the 
results. It has four modes, plus a special mode, and provides an impressive amount of functionality from these modes. 

You need Views if: 

• You like the default front page view, but you find you want to sort it differently. 

• You like the default taxonomy/term view, but you find you want to sort it differently; for example, alphabetically. 

• You use /tracker, but you want to restrict it to posts of a certain type. 

• You like the idea of the 'article' module, but it doesn't display articles the way you like. 

• You want a way to display a block with the 5 most recent posts of some particular type. 

• You want to provide 'unread forum posts'. 

• You want a monthly archive similar to the typical Movable Type/Wordpress archives that displays a link to the in the form of 
"Month, YYYY (X)" where X is the number of posts that month, and displays them in a block. The links lead to a simple list of 
posts for that month. 


Views can do a lot more than that, but those are some of the obvious uses of Views. 


Releases 

Official releases 

Date 

Size 

Links 



Status 1 


6.x-2.0-rcl 

2008-JUI-02 

2.67 MB 

Download 

■ Release notes ■ 

Edit 

Recommended for 6.x 

y 

5.X-1.6 

2007-JUI-14 

207.36 KB 

Download 

■ Release notes ' 

Edit 

Recommended for 5.x 

y 

4.7.x-1.6 

2007-Jul-14 

169.88 KB 

Download 

■ Release notes ■ 

Edit 

Recommended for 4.7.x 

y 


The Views project page shows only the official releases; other project pages 
frequently show development snapshots. The Status column, indicated by Item 1 in 
the preceding screenshot, gives you information about the different versions that are 
available. In most cases, you should only use official releases that have a status of 
Recommended. Also, the version of the module needs to match up with the version 
of Drupal; for example, only the 6.x versions of modules work with Drupal 6. 

In this case, we want to install Views for Drupal 6, so we click the Download link, 
indicated by Item 2 in the preceding screenshot, to download the module. 

Then, repeat these steps for the Advanced help module at 
http://drupal. org/proj ect/advanced_hel p. 

To keep your downloaded code organized, create a folder to use 
specifically for this purpose. 
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Step 2: Decompress 

Once you have downloaded the code from d r u p a I , o r g to your computer, 
decompress the file. On a Mac or Linux machine, this will occur automatically; 
on a PC, use 7-zip (an open-source utility available at http: / / www. 7-zip. org) to 
decompress the tarball into the Views directory. 

Step 3: Upload 

Open your FTP client, and upload the directory containing the module (in our case. 
Views) to the si tes/al I / mo d u I es directory as shown in the following screenshot: 

If you were uploading a theme, you would upload the t h e me folder into 
s i t e s / a I I /1 h e me s directory. 
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Step 4: Enable 

Once the modules have been successfully uploaded into your si tes/al l/modul es 
directory, click the Administer | Site Building | Modules link, or navigate to 
ad mi n/bui I d/modul es as shown in the following screenshot: 


V Other 


Enabled 

Name 

Version 

Description 

0 

Advanced 

help 

6.X-1.0 

Allow advanced help and documentation. 

Required by: Advanced help example (disabled) 

□ 

Advanced 

help 

example 

6.X-1.0 

A example help module to demonstrate the advanced help module. 

Depends on: Advanced help (enabled) 


Enabled 

Name 

Version 

Description 




Create customized lists and queries from your database. 

0 

Views 

6.x-2.0-rcl 

Required by: Calendar (enabled). Calendar iCal (enabled). Calendar Popup (enabled). Organic groups 
(disabled), Vieve exporter (enabled). Views UI (enabled). Organic groups access control (disabled). Organic 
groups panels (disabled) 

0 

Views 

exporter 

6.x-2.0-rcl 

Allows exporting multiple views at once. 

Depends on: Views (enabled) 

0 

Views 

UI 

6.x-2.0-rcl 

Administrative interface to views. Without this module, you cannot create or edit your views. 

Depends on: Vieve (enabled) 


[ Save configuration 1 


This screen gives a breakdown of the modules that you have uploaded into your 
s i t e s / a I I / mo d u I e s folder. 

To enable the Advanced help module, select the checkbox next to Advanced help. 

To enable the Views module, select the checkboxes next to the Views, Views 
exporter, and Views UI modules. Click the Save configuration button to save your 
settings and enable your modules. You will receive a confirmation message at the top 
of the screen. 


Many modules are actually a collection of related modules. For example, 
, the Views module comes with three related modules. Before you install 
Q any module, you should read the README, t X t and the I N S T A L L. t X t 
files that come with most modules. These files are usually located in the 
base directory of the module download. 
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Configuring Modules and Themes 

Now that we have finished installing modules and themes, we need to 
configure them. 

Modules 

Once you have enabled a new module, you should check to see if there are any 
configuration options for the module. To do this, navigate to the main administration 
page, either by clicking Administer, or by navigating to a d mi n. Then, click the By 
module tab as shown in the following screenshot: 



By looking at the page, we see that both the Views module and the Advanced help 
module have links to Configure permissions. These permissions are covered in more 
detail later in this chapter, in the Creating Views section. 
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Themes 

After you have uploaded a theme into the sites/all/the me s directory, you will 
need to enable it via the Administer | Site Building | Themes link, or by navigating 
to a d mi n / b u i I d / t h e me s . Themes and their different settings are covered in more 
detail in Chapter 14: Theming and User Interface Design. 

Modules and Themes: A Summary 

As described in this section, installing modules and themes involves four steps: 

1. Download 

2. Decompress 

3. Upload 

4. Enable 

Modules are uploaded into s i t e 5 / a I I / mo d u I e s , and themes are uploaded into 
s i t e s / a I I /1 h e me s. 

Modules, once uploaded, are enabled at a d mi n / b u i I d / mo d u I e s. 

Themes, once uploaded, are enabled at a d mi n / b u i I d / t h e me s. 

Although different modules and themes will have varying configuration settings, the 
above steps will remain constant for any module or theme you use on your site. 

Creating Roles 

Although roles are covered in more detail in Chapter 5: Enrolling Students and 
Chapter 6: Creating the Student Blog, we will briefly cover how to create roles here. 
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To create a new role, click the Administer | User Management | Roles link, or 
navigate to a d mi n/ user / rol e s as shown in the following screenshot: 



As seen by Item 1, you need to enter the name of the role. Once you have entered the 
name, click the Add role button. 

Add three roles: teacher, student, and site admin. 

Creating Content Types 

As we build this site, we will build a range of content types for different functions. 
Although these different content types will have varied uses throughout the site, the 
basic process for creating content types remains consistent. 

A content type and a node type mean the same thing. In most situations, 
a node is a piece of content. 
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Getting Started 


For this example, we will create a content type for storing and sharing bookmarks. 
Adding new content types requires the following steps: 

1. Create the content type. 

2. Add fields to the content type (this is optional: not all content types require 
additional fields). 

3. Assign a taxonomy to the content type (this is optional: not all content types 
will be organized using taxonomy). 

4. Assign privileges to the content type. 

Of these four steps, only steps one and four need to happen for all new content types. 
As we will discuss, some content types do not require additional fields, and some 
content types are not associated with a taxonomy. 

Step 1: Creating the Content Type 

Click the Administer | Content management | Content types link, or navigate to 
ad mi n/content/types. Click the Add content type link, or the Add a new content 
type link, as shown in the following screenshot: 
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This brings you to the administrative screen to add a content type, accessible at 
ad mi n/content/types/add. As shown in the following screenshot, this screen has 
four sections: 

• Identification 

• Submission form settings 

• Workflow settings 

• Comment settings 
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A: Identification 

As seen in the preceding screenshot, the Identification section contains three fields: 

1. The Name field provides a human-readable name for the content type. The 
name for a content type should provide a general sense of what the content 
type will be used for. In this example, as we are creating a node type that will 
store bookmarks, we will name the content type Bookmark. 

2. The Type field holds the machine-readable name of the node type. Values 
entered into the Type field can only contain alphanumeric characters (a-z 
and 0-9) and underscores. Generally, the Type should relate to the Name; in 
this example, the Type is bookmark. 

3. The Description field holds a more detailed description of what the content 
type is used for. The description field can hold h t ml , so a description can 
contain, for example, links to external pages. Typically, a good description 
is brief. For the bookmark, we will use: Add a bookmark that points to an 
external website. 

B: Submission Form Settings 

You can view the different fields on the Submission form settings page as shown in 

the following screenshot: 
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The values in the various Submission form settings fields allow you to customize 
what appears to people as they add content on your site. The following screenshot 
shows where these values appear when people are adding content: 



Compare this form with the submission form settings screenshot just above to see the 
relationship between the two pages. 

When creating new content types, the only value that requires changing is the 
Explanation or submission guidelines field. In this example, and in many cases, we 
can use the same text that we used for the Description field: Add a bookmark that 
points to an external web site. 
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C: Workflow Settings 

You can view the different fields on the Workflow settings page as shown in the 
following screenshot: 


w Workflow settings 

Default options: 

0 Published 

0 Promoted to front page 
0 Sticky at top of lists 
0 Create new revision 

Users with the administer nodes permission will be able to override these options. 

Attachments: 

© Disabled 
O Enabled 


The Workflow settings cover the basic rules for what happens to a piece of content 
when it is created and edited. Under the Default options, you will want to select 
Published; without this, regular users will not be able to see your content. 

Of the other options, the most commonly used is the Create new revision feature. 
Selecting this option allows you to create wiki-like functionality; each time a piece of 
content is edited and saved, it creates a revision, and users with sufficient privileges 
can view and revert older revisions. 

The other two flags (Promoted to front page and Sticky at top of lists) are useful if 
you are using Drupal's default home page, or default organization. In most cases, 
however, we will be organizing our content using the views module, and these flags 
will be of limited use. 

The Attachments settings allow you to specify whether users can attach files 
to content. In most cases, it makes sense to allow attachments. In this example, 
however, as we are saving bookmarks, attached files are unnecessary. 
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D: Comment Settings 

You can view the different fields on the Comment settings page as shown in the 
following screenshot: 


S7 Comment settings 

Default comment setting: 

O Disabled 
O Read only 
® Rea d/Write 

Users with the administer comments permission will be able to override this setting. 

Default display mode: 

O Flat list - collapsed 
O Flat list - expanded 
O Threaded list - collapsed 
® Threaded list - expanded 

The default view for comments. Expanded views display the body of the comment. Threaded views keep replies 
together. 

Default display order: 

O Date - newest first 
® Date - oldest first 

The default sorting for new users and anonymous users while viewing comments. These users may change their 
view using the comment control panel. For registered users, this change is remembered as a persistent user 
preference. 

Default comments per page: 

1 50 &I 

Default number of comments for each page: more comments are distributed in several pages. 

Comment controls: 

O Display above the comments 
O Display below the comments 
O Display above and below the comments 
® Do not display 

Position of the comment controls box. The comment controls let the user change the default display mode and 
display order of comments. 

Anonymous commenting: 

Anonymous posters may not enter their contact information 
Anonymous posters may leave their contact information 
• Anonymous posters must leave their contact information 

This option is enabled when anonymous users have permission to post comments on the permissions page. 

Comment subject field: 

O Disabled 
® Enabled 

Can users provide a unique subject for their comments? 

Preview comment: 

® Optional 
O Required 

Forces a user to look at their comment by clicking on a 'Preview' button before they can actually add the comment 

Location of comment submission form: 

O Display on separate page 
® Display below post or comments 

[ Save content type~] 
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The most important setting in this section is the first one. Default comment setting. 
If you want to allow comments, set this to Read/Write. If you don't want to allow 
comments on this node type, select Disabled. 

The second most important setting is Anonymous commenting (which is grayed 
out in the preceding screenshot, as anonymous users have not been given the right 
to comment). If you allow anonymous users to comment, you should require them 
to leave their contact information, and use one of the spam control modules. The 
Recaptcha module (http: / /drupal . org/proj ect/recaptcha)isa decent first line 
of defense against spammers; if you have ongoing issues with spammers getting 
past recaptcha, Mollom (http://drupal .org/project/mol I om) provides superb 
spam control. 

The third most important setting is Preview comment. Set this to Optional, 
as requiring users to preview their comments is an added step that can inhibit 
interaction on your site. 

The remaining settings in this section are largely cosmetic, and the correct settings 
here tend to be a matter of taste. The settings shown in the preceding screenshot are 
sensible defaults that get you a nested comment thread, with earlier posts at the top 
of the thread. 

Once you have set the defaults, click the Save Content Type button to create your 
new content type. 

Step 2: Adding Fields 

Once the content type has been created, we need to add fields. To add fields 
to content types, we need to install the Content Construction Kit, or CCK. 
Additionally, because we are creating a bookmark and need to store a link, we need 
to install the Link module. 

CCK can be downloaded from http://drupal , org/proj ect/cck, while the Link 
module can be downloaded from http://drupal.org/project/link. 

Once you have downloaded and extracted the modules, upload them into 
sites/all /mo dules as described earlier in this chapter, and then click the 
Administer | Site Building | Modules link, or navigate to admi n/ bui I d / modul es 
to enable them. 
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CCK allows you to add fields to content types, and the project download 
includes several sub-modules. In this section, we will enable the 
various CCK-related modules we will use throughout this book. In later 
chapters, we will install additional modules that will further extend the 
functionality of CCK. 


Enabled 

Name 

Version 

Description 




Allows administrators to define new content types. 

Required by: Content Copy (disabled). Content Permissions 

a 

Content 

6.x-2.0-rc4 

(disabled). Date (enabled). Date Copy (disabled), Fieldgroup 
(disabled). Link (disabled). Node Reference (disabled), Number 
(disabled). Option Widgets (disabled). Text (disabled). User 

Reference (disabled) 

□ 

Content 

Copy 

6.x-2.0-rc4 

Enables ability to import/export field definitions. 

Depends on: Content (enabled) 

□ 

Content 

Permissions 

6.x-2.0-rc4 

Set field-level permissions for CCK fields. 

Depends on: Content (enabled) 

a 

Fieldgroup 

6.x-2.0-rc4 

Create field groups for CCK fields. 

Depends on: Content (enabled) 

H*0 

Link 

6.X-2.3 

Defines simple link field types. 

Depends on: Content (enabled) 

a 

Node 


Defines a field type for referencing one node from another. 

Reference 

6.x-2.0-rc4 

Depends on: Content (enabled). Text (disabled). Option Widgets 
(disabled) 

0 

Number 

6.x-2.0-rc4 

Defines numeric field types. 

Depends on: Content (enabled) 




Defines selection, check box and radio button widgets for text and 

0 

Option 

Widgets 

6.x-2.0-rc4 

numeric fields. 

Depends on: Content (enabled) 

Required by: Node Reference (disabled). User Reference (disabled) 

0 



Defines simple text field types. 

Text 

6.x-2.0-rc4 

Depends on: Content (enabled) 

Required by: Node Reference (disabled). User Reference (disabled) 



User 


Defines a field type for referencing a user from a node. 

0 

Reference 

6.x-2.0-rc4 

Depends on: Content (enabled). Text (disabled). Option Widgets 
(disabled) 
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Of all the modules shown in the preceding screenshot, only the Link module is not a 
part of the main CCK download. 

Enable the modules as shown. Once you have enabled the modules, navigate 
to Administer | Content Management | Content Types link, or navigate to 
ad mi n/content/types. 
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Click the Manage fields link to get to the screen shown in the following screenshot: 



As shown in the above screenshot, when adding your new field, you need to enter 
the following information: 

• A Label; in this example. Link to source 

• A Field name; in this example, link 

• A Type of data; in this example. Link 

Then, depending on the type of data to be stored in the field, you will be presented 
with some widget options for the Form element used to edit the data. While some field 
types have many different widgets, the Link field only offers one option: Text fields 
for Title and URL. 
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Getting Started 


After selecting the appropriate options, click the Save button to save your field and 
move on to the configuration screen. 


Home > Bookmark 


Link to source 


Edit 


Manage fields 


Display fields 


Bookmark basic information 

Label: 

| Link to source 

Widget type: 

| Text Fields for Title and URL | 

[ Change basic information ~] 


Bookmark settings 

These settings apply only to the Link to source field as it appears in the Bookmark content type. 

Help text: 

Enter a link to an external web site. Most links will start with http:// 

i 


Instructions to present to the user below this field on the editing form. 

Allowed HTML tags: <a> <b> <big> <code> <del> <em> <i> <ins> <pre> <q> <small> <span> <strong> <sub> <sup> <tt> 
<ol> <ul> <li> <p> <br> <img> 

The ID for excluding or including this element is: edit-description - the path is: admin/content/node-type/bookmark/fields 
/field_link 

l Default value 


Global settings 

These settings apply to the Link to source field in every content type in which it appears. 

0 Required 2 

Number of values: 

li " a 

Maximum number of values users can enter for this field. 

'Unlimited' will provide an 'Add more' button so the users can add as many values as they like. 

Warning! Changing this setting after data has been created could result in the loss of data! 

□ Optional URL 

If checked, the URL field is optional and submitting a title alone will be acceptable. If the URL is ommitted, the title will be 
displayed as plain text. 

Link Title: 

O Optional Title 3 
O Required Title 

O Static Title: [ | 

® No Title 

If the link title is optional or required, a field will be displayed to the end user. If the link title is static, the link will always use 
the same title. If token module is installed, the static title value may use any other node field as its value. Static and 
token-based titles may include most inline XHTML tags such as strong, em, img, span. etc. 

URL Display Cutoff: 



If the user does not include a title for this link, the URL will be used as the title. When should the link title be trimmed and 
finished with an elipsis (...)? Leave blank for no limit. 

Link Target: 

® Default (no target attribute) 

O Open link in window root 
O Open link in new window 
O Allow the user to choose 

Rel Attribute: 

re| -~ l l ~ 

When output, this link will have this rel attribute. The most common usage is rel="nofollow" which prevents some search engines 
from spidering entered links. 

Additional CSS Class: 


When output, this link will have have this class attribute. Multiple classes should be separated by spaces. 

[ Save field settings | 
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In configuring the link field, in most cases, the default settings will work. For the 
bookmark, we make three changes, marked 1 to 3 in the preceding screenshot. 

Item 1 is the Help text. As the name implies, this text can be used to give instructions 
to the person filling out the form. 

Item 2 makes the field Required; given that the purpose of this content type is to 
store bookmarks, the Link field is a required field. 

Item 3 removes the title from the link field. Given that the node already has a title, 
requiring a title for the link as well would be redundant. 

Once the settings have been adjusted, click the Save field settings button. 

This returns you to the Manage fields administrative screen. On this page, you can 
order your fields using drag and drop; click the Save button to record any changes. 

Step 3: Assigning Taxonomies 

Once you have created a node type, you need to decide whether or not you will 
use taxonomy to organize or categorize the posts made with that content type. For 
bookmarks, we want users to be able to use tags to categorize their links. 

To add a taxonomy, click the Administer | Content Management | Taxonomy link, 
or navigate to ad mi n/content/taxonomy. Click the Add vocabulary link shown in 
the following screenshot: 


Home > Administer > Content management 
Taxonomy Add vocabulary 


The taxonomy module allows you to categorize your content using both tags and administrator defined terms. It is a flexible 
tool for classifying content with many advanced features. To begin, create a 'Vocabulary' to hold one set of terms or tags. You 
can create one free-tagging vocabulary for everything, or separate controlled vocabularies to define the various properties of 
your content, for example 'Countries' or 'Colors'. 


Use the list below to configure and review the vocabularies defined on your site, or to list and manage the terms (tags) they 
contain. A vocabulary may (optionally) be tied to specific content types as shown in the Type column and, if so, will be 
displayed when creating or editing posts of that type. Multiple vocabularies tied to the same content type will be displayed in 
the order shown below. To change the order of a vocabulary, grab a drag-and-drop handle under the Name column and drag 
it to a new location in the list. (Grab a handle by clicking and holding the mouse while hovering over a handle icon.) 
Remember that your changes will not be saved until you click the Save button at the bottom of the page. 


[more help...] 


Name Type Operations 

No vocabularies available. 
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Clicking the Add Vocabulary link brings you to the screen shown in the 
following screenshot: 
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Identification 

In the Identification section, you need to provide a Vocabulary name, a Description, 
and some Help text. The name should be somewhat intuitive, and as this vocabulary 
will be used to describe posts, we will call it Keywords. The description of the 
vocabulary is more for administrative purposes, as it is not displayed anywhere on 
the site by default. The help text is explanatory text for the end user. 

Content Types 

In this section, you select what node types will be categorized by this taxonomy. In 
this example, we will select Bookmarks; as we progress through the book we will 
add several other content types into this list. 

Settings 

The Tags setting determines whether the list of terms will be added by individual 
users (known as freetagging), or whether the list of terms will be determined by a 
site administrator (a controlled vocabulary). Selecting Tags means that this will be a 
freetag vocabulary. 

Multiple Select means that more than one term can be applied to a post. 

While this is always true for freetag vocabularies, it becomes more relevant for 
controlled vocabularies. 

Required determines whether or not a user needs to select a term. 

Once you have adjusted the settings, click the Save button to save your preferences. 

Step 4: Assigning Privileges 

The final step in preparing content types for use on your site is to assign privileges 
via user roles. To do this click the Administer | User Management | Roles link, or 
navigate to a d mi n/ user / rol e s. 

For this example, we will assign permissions to the teacher role. 

[ For more information on roles and how to use them effectively | 

xT-/,.. within your site, see Chapter 4: Creating a Teacher Blog and I 

Chapter 5: Enrolling Students. I 
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To assign rights for teachers, click the edit permissions link to the right of the entry 
for teacher as shown in the following screenshot: 



Then, on the Permission page, scroll down to the section titled node module. 
As pictured in the following screenshot, give the teacher role the rights to 

create bookmark content, delete own bookmark content, and edit own 
bookmark content. 
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Permission 

teacher 

node module 

access content 

□ 

administer content types 

□ 

administer nodes 

□ 

create book content 

□ 

create bookmark content 

-* 0 

create page content 

□ 

create story content 

□ 

delete any book content 

□ 

delete any bookmark content 

□ 

delete any page content 

□ 

delete any story content 

□ 

delete own book content 

□ 

delete own bookmark content 

-*0 

delete own page content 

□ 

delete own story content 

□ 

delete revisions 

□ 

edit any book content 

□ 

edit any bookmark content 

□ 

edit any page content 

□ 

edit any story content 

□ 

edit own book content 

□ 

edit own bookmark content 

-*0 

edit own page content 

□ 

edit own story content 

□ 

revert revisions 

□ 

view revisions 

□ 


Click the Save permissions button to save your settings. 
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Getting Started 


The Result 

Click the Create content link, or navigate to node/add. Click the Bookmark link, 
which brings you to node / add / bookmark. 



Enter the required information, and then click the Save button to save your 
new bookmark. 

Creating Content Types: A Summary 

Creating content types has four steps: 

1. Create the content type 

2. Add fields (optional) 

3. Assign taxonomy (optional) 

4. Assign permissions 
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Chapter 3 


These steps will apply to all new content types created on the site. In some cases, 
new content types will not require additional fields or taxonomy; however these 
steps will guide you through the general process of creating new content types. 

Creating Views 

The Views module allows site administrators to sort and display content created on 
the site. The views module is incredibly flexible, but initially, the process of creating 
views can seem daunting. 

In this section, we will examine the basic steps that you will follow as you create 
different views on your site. Although each view will vary depending on what you 
are trying to show, the steps outlined here provide the basis for getting started. 

To create a view, follow these steps: 

1. Add a view: The View type determines what type of data will be shown in 
the view. The next steps determine how it will be displayed. 

2. Set the defaults 

a. Add fields to the view 

b. Add filters 

c. Add arguments 

d. Set style 

e. Set additional configuration options 

3. Add a display type 

a. Define multiple display types (optional) 

b. Override the default values (optional) 

In this example, we will create a view that displays bookmarks, and all terms 
connected with those bookmarks. 
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Getting Started 


Step 1: Add a View 

To add a view, click the Administer | Site Building | Views link, or navigate to 
ad mi n/ bu i I d/ v i ews: 


Packt and Drupal 


Search this site: 

I II 


Search 1 


bill 

° My account 
o Create content 
° Recent posts 
v Administer 

t> Content management 
^ Site building 
° Blocks 
° Contact form 
l> Menus 
o Modules 
° Themes 
° Triggers 
° URL aliases 
° Views 

l> Site configuration 
l> User management 
Reports 

° Advanced help 
o Help 
° Log out 


Home > Administer > Site building 

Views EH Add Import Tools | 
Not sure what to do? Try the "Getting started" page. 

Tag: Displays: Type: 


| <All> 

v | | <All> 

LYl| | <AII> 

v | | <All> 

v l 

Sort by: 

Order: 




| Name 

iSI |up l?*jl 

[ Apply ] 




© Default Node view: archive (default) 

Enable 

Path: archive 

Display a list of months that link to content for that 

Block, Page 

month. 

© Default Node view: backlinks (default) 

Enable 

Path: node/%/backlinks 

Displays a list of nodes that link to the node, using the 

Block, Page 

search backlinks table. 

© Default Comment view: comments_recent (default) 

Enable 

Title: Recent comments 

Contains a block and a page to list recent comments; the 

Path: comments/recent 

Block, Page 

block will automatically link to the page, which displays 
the comment body as well as a link to the node. 

© Default Node view: frontpage (default) 

Enable 

Path: frontpage 

Emulates the default Drupal front page; you may set the 
default home page path to this view to make it your front 

Feed, Page 

page. 

© Default Node view: popular (default) 

Enable 

Title: Popular content 

Path: popular/all 

Block, Page 

Shows the most-viewed nodes on the site. 

© Default Node view: taxonomy_term (default) 

Enable 

Path: taxonomy/term/% 

A view to emulate Drupal core's handling of 
taxonomy/term; it also emulates Views l's handling by 


having two possible feeds. 

© Default Node view: tracker (default) 

Enable 

Title: Recent posts 

Path: tracker 

Page 

Shows all new activity on system. 




t 


The Views administration page, shown in the preceding screenshot, provides tools 
for finding, creating, and organizing views. Item 1 provides the links for Listing, 
Adding, and Importing views. Item 2 provides options for sorting and organizing 
views. The fieldset indicated by Item 3 lists and describes the different views saved 
on the site. 
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Chapter 3 


Click the Add tab; this brings you to ad mi n/bui I d/vi ews/add. 

This screen gives you four options: 

1. View name: This is the name of the view, and can only contain letters, 
numbers, and underscores. 

2. View description: This field holds a brief description that is displayed on the 
view's administrative page. 

3. View tag: This optional value allows you to categorize your views using tags. 
This can be useful on a site where you are using a lot of views. 

4. View type: You can use views to display different collections of information; 
the view type specifies what type of data you'll be collecting. 

The most significant setting on this screen is the View type, as this determines what 
type of information will be shown in the view. Although views can be used to collect 
and display a broad array of information, in this book we will focus largely on using 
views to display nodes, or content, created by site members. 
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Getting Started 


For this view, as shown in the preceding screenshot, our settings are as follows: 

1. View name: bookmarks_all 

2. View description: All bookmarks created on the site 

3. View tag: public_view 

4. View type: Node 

Click the Next button; this brings you to the Edit view screen, as shown in the 
next screenshot. 


Step 2: Set the Defaults 

The default view holds the Basic settings for the view. The settings stored in the 
defaults are used in Step 3, where we will add a Display type. 

The initial Edit view screen allows us to edit the default values for the view. 


Home > Administer > Site building > Views 


Edit view "bookmarks all" 


List 


Add 


Edit 


Import 


Tools 


View bookmarks_all, displaying items of type Node. Export Clone New view 


Defaults ► Q Defaults Default settings for this view. 


1 Page 1*31 

View settings 

Tag: public_view 

© Relationships + 

None defined 

© Sort criteria + 

None defined 

( Add display ] 


Basic settings 

Name: Defaults 

Title: None 

^fcStyle: Unformatted # 

^^Row style: Fields JSL 

Use AJAX: No 

©Arguments n fit* 

None defined 

© Filters + Iff 1 

None defined 

[ Analyze | 

d-"* 

© Fields — +l**l 

None defined 


Use pager: No 
Items to display: 10 
More link: No 
Distinct: No 
Access: Unrestricted 
Header: None 
Footer: None 
Empty text: None 
Theme: Information 


Click on an item to edit that item's details. 


[ Save ] [ Cancel ] 


Live preview 


Display: 

Arguments: 


1 Defaults v 1 

1 

[ Preview ] 

Separate arguments with a / as though they were a URL path. 
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Chapter 3 


The process of setting the default values for the view requires: 

• Adding Fields, indicated by Item a 

• Adding Filters, indicated by Item b 

• Adding Arguments, indicated by Item c (optional) 

• Setting the Style, indicated by Item d (optional) 

• Additional configuration (optional), an overview of which is given below. 

Step a: Adding Fields 

To add fields to your view, click the + icon next to the Fields option, as indicated by 
Item 1 in the following screenshot: 
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Getting Started 


This brings up the list of available fields. These fields can be organized by group, as 
shown by Item 2 in the preceding screenshot, and also in the following screenshot: 



You can select a specific group to limit the number of fields you see, thus making 
the field list easier to navigate. For our example—creating a view showing all saved 
bookmarks—we will select Node fields first. Content fields second, and Taxonomy 
fields third. 

Node Fields 

For Node fields, select the Node: Title and the Node: Updated/commented date 
field, as shown in the following screenshot: 



Once you have selected these fields, select Content from the Groups 
drop-down menu. 
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You DO NOT need to click the Add button when navigating between 
different groups. Click the Add button after you have selected all of the 
fields you want to include. 

Content Fields 

Content fields list all fields that have been added using CCK-related modules. In 
this site, the only field we have added so far is the Link field for the Bookmark. As 
shown in the following screenshot, this is the only option we have under the 
Content option: 




Select the Content; Link: Link to Source field, and then select Taxonomy from the 
Groups drop-down menu. 


Taxonomy Fields 

Select Taxonomy: All Terms, as shown in the following screenshot: 
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Getting Started 


As this is the last field we need to add, click the Add button. This will automatically 
bring us to the wizard that walks us through configuring some display options for 
these fields. 

Configuring the Fields 

Once you choose to add fields to your view, you will automatically be prompted to 
configure your newly-added fields. 

[ The fields will be presented to you alphabetically based on field group. j 

vV.. After you have configured them, you will be able to order them as you I 

want, as described later in this section. I 

The first field we are presented with is the Link: Link to Source field, as shown in 
the following screenshot: 



In the Format drop-down menu, we select the URL, as link option. This specifies 
that the URL will work as a link to the stored location. For the Label, we will use the 
same value we created when we added the node type earlier in this chapter. 

Click the Update button to configure the next field type. 
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The second field we are presented with is the Node: Title field, as shown in the 
following screenshot: 



For this field, we need to select the Link this field to its node option. This option 
provides a link back to the original bookmark. 

Click the Update button to configure the next field type. 

The third field we are presented with is the Node: Updated/commented date field, 
as shown in the following screenshot: 



For this field, we do not need to alter the default values. 
Click the Update button to configure the next node type. 
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Getting Started 


The fourth (and final) field we are presented with is the Taxonomy: All terms field, 
as shown in the following screenshot: 



When configuring this field, we will make the following changes from the default 
values. The preceding screen is a screenshot after these changes have been made. 

• The Label is Keywords; this field will show terms from the Keywords 
vocabulary; 

• The Empty list text will read No terms available for this post. 

• Select Limit terms by vocabulary, and select the Keywords vocabulary. 

Click the Update button to finish configuring these fields. 
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Then, click the Rearrange icon as shown in the following screenshot. This allows us 
to re-order the fields within the view. 


Style: Unformatted 
Row style: Fields 
Use A]AX: No 
Use pager: No 
Items to display: 10 
More link: No 
Distinct: No 
Access: Unrestricted 
Header: None 
Footer: None 
Empty text: None 
Theme: Information 


Defaults: Rearrange fields 


J5LI 


© Fields +\U 

Content: Link: Link to Source 
(field_link) URL, as link 
Node: Title Title 
Node: Updated/commented 
date Updated/commented 
date 

Taxonomy: All terms 
Keywords 


Click this icon to 
rearrange the display 
order of fields. 


Fields can be rearranged using drag and drop. 


+ 

Node: Title Title 5 * 

SI 

+ 

Node: Updated/commented date Updated/commented date 5 * 


* 

Content: Link: Link to Source (fieldjink) URL, as link 

O 

•F 

Taxonomy: All terms Keywords 



I Update] [ Cancel 1 


Click the Update button to save the changes. 

Step b: Adding Filters 

Once we have finished configuring the fields for our views, you can see the Live 
preview of the view, which includes some technical information about the view, 
including the actual query used to build it, and how long it took to render. 


Live preview 


Display: 

Arguments: 



| Defaults iy 

il l 


J [ Preview ] 


Separate arguments with a / as though they we 

re a URL path. 



Title: The First Bookmark 

Updated/commented date: 07/17/2008 - 8:17am 
Link to Source: http://www.google.com 
Keywords: google, research, search, utilities 
Title: Sample blog post 

Updated/commented date: 07/19/2008 - 1:51pm 
Link to Source: 

Keywords: No terms available for this post 
Title: Sample page 

Updated/commented date: 07/19/2008 - 1:51pm 
Link to Source: 

Keywords: No terms available for this post 
Title: The second sample page 
Updated/commented date: 07/19/2008 - 1:52pm 
Link to Source: 

Keywords: No terms available for this post 
Title: The Themes Page on Drupal.org 
Updated/commented date: 07/19/2008 - 1:54pm 
Link to Source: http://drupal.org/project/themes 
Keywords: design, drupal, themes 
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Getting Started 


If, however, you look at the Live preview screen as shown in the preceding 
screenshot, you can see that several posts returned in this view do not show any 
information for the Link to Source field. As this view is currently configured, it 
returns all content types. In the next step, we will apply a filter to this view so that 
the view will only display Bookmarks. 



To add filters to the view: 

• Click the Add filter icon, as indicated by Item 1 in the preceding screenshot. 

• From the Groups drop-down menu, select Node, as shown by Item 2. 

• Select Node: Published or admin, as shown by Item 3. 

• Select Node: Type, as shown by Item 4. 
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Chapter 3 


Click the Add button to save these options; this will bring you to a wizard that walks 
you through the options for configuring your filters. 



As shown in the preceding screenshot, filters can be exposed to the end user. An 
exposed filter allows site members to select options within the filter. This allows the 
view to be more dynamic. In some cases this is useful, but in others cases, it's not 
necessary. In this example, where we are creating a view that shows all bookmarks 
saved in the view, we do not need to expose any filters. 

The first filter presented is Node: Published or admin. No options need to be set for 
this filter; click the Update button to configure the next filter. 

The next filter presented to us is the Node: Type filter, as seen in the 
following screenshot: 
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Getting Started 


We set the filter to only show Bookmark, and then click the Update button. You 
can see the changes to the view by looking at the Live preview pane, shown in the 
following screenshot: 


Live preview 


Display: 

Arguments: 


1 Defaults v 

r 

[ Preview ] 

Separate arguments with a / as though they were a URL path. 


Title: The First Bookmark 

Updated/commented date: 07/17/2008 - 8:17am 
Link to Source: http://www.google.com 
Keywords: google, research, search, utilities 
Title: The Themes Page on Drupal.org 
Updated/commented date: 07/19/2008 - 1:54pm 
Link to Source: http://drupal.org/project/themes 
Keywords: design, drupal, themes 


The preceding screenshot shows a Live preview of the view, with filters enabled. 
Compare this form with the first screenshot under section Adding Filters, which 
shows the same view with no filters. 

Step c: Adding Arguments (optional) 

Arguments allow you to filter the content returned in a view through a value in the 
URL; for example, using arguments you can filter for content created by a specific 
user based on their username — http://yoursite.org/your-custom-view/harry 
would give you all posts by user harry, and http://yoursi te, org/your-custom- 
v i e w/1 o m would give you all posts by user tom. 

Adding arguments is not necessary for all views, and views can function perfectly 
well without arguments. Used effectively, however, arguments can add a level of 
flexibility not possible with filters. Arguments are covered in Chapter 13: Tracking 
Student Progress. 
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Step d: Setting Style 

The Style settings allow you to specify how the view will be displayed on the page. 
The default style is unformatted; this allows for the view to be adjusted via CSS. In 
this example, we want to create a table view. 

To get started, click the Unformatted link next to Style in the Basic settings section, 
as shown in the following screenshot by Item 1: 


© Arguments + ©Filters +lti 

None defined Node: Published or admin 

Node: Type = Bookmark 

© Fields +l*+l 

Node: Title Title 

Node: Updated/commented date 
Updated/commented date 
Content: Link: Link to Source 

(field _ link) URL, as link 

Taxonomy: All terms Keywords 

Header: None 
Footer: None 
Empty text: None 
Theme: Information 

© Defaults: How should this view be styled 

O Calendar 
O Grid 
O List 

® Table 2 

O Unformatted 

If the style you choose has settings, be sure to click the settings button that will appear next to it in the View 
summary. 

You may also adjust the settings for the currently selected style by clicking on the icon. 

[Update] [Cancel] 


Basic settings 

Name: Defaults 
Title: None 

Style: Unformatted # 

Row style: Fields 
Use AJAX: No 
Use pager: No 
Items to display: 10 
More link: No 
Distinct: No 
Access: Unrestricted 
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Getting Started 


Then, select the Table option, and click the Update button. This brings you to the 
Style options screen as shown in the following screenshot: 



As shown in the preceding screenshot by Item 1, you need to select Default sort for 
the Updated/commented date, and select Descending for Default sort order. This 
will show the most recently-added or commented on bookmarks at the top of 
the table. 

You also want to Enable Drupal style "sticky" table headers (Javascript). This 
setting makes it such that the heading of the table scrolls down the page if the list 
goes longer than one screen. 

Click the Update button to save your settings. 

To see the effect of the new settings, look at the Live preview pane shown in the 
following screenshot: 
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Live preview 


Display: Arguments: 




1 Defaults v-|| 1 


| Preview ] 


Separate arguments with a / as though they 

were a URL path. 


Lfcditj LtxportJ lUcnej 




Title 

Updated/commented 

date 

Link to Source 

Keywords 

The Themes Page on 
Drupal.org 

07/19/2008 - 1:54pm 

http ://drupal.org/project/themes 

design, drupal, themes 

The First Bookmark 

07/17/2008 - 8:17am 

http://www.google.com 

google, research, search, 

utilities 


At this point, the view is functionally complete. However, there are some additional 
configuration options that can be used to fine-tune and enhance views. 

Step e: Setting Additional Configuration Options 

As is probably clear at this point, the Views module exposes an enormous amount 
of functionality that can be accessed via different configuration options. Although 
views can function perfectly well without adjusting these last few settings, these 
options help you to create views that make more sense for people using your site. 


Basic settings 

Name: Defaults 

1 Title: None 

Style: Table & 

Use AJAX: No 
Use pager: No 

2 Items to display: 10 
More link: No 
Distinct: No 

3 Access: Unrestricted 
^Header: None 

Footer: None 
5Empty text: None 
Theme: Information 


Item 1, Title: The Title lets you set a title for your view. For this example view, we 
will set the title to All Bookmarks. 

Item 2, Items to display: This setting lets you adjust the number of items to display 
on a single page. The default is 10; for table views, you can show more content by 
setting it higher. For this example view, we will set it to 30. 

Item 3, Access: This setting allows you to control access to the view based on user 
roles, or user permissions. 
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Getting Started 


Item 4, Header and Footer: These settings allow you to set headers and footers for 
your view. 

Item 5, Empty text: This setting allows you to set a message if the view does not 
return any data. Setting empty text is recommended when you expose filters to end 
users, as user can potentially set filters that do not return any data. 

Step 3: Add a Display Type 

When you add a display type to your view, you provide a method of displaying 
the data returned by your view. The most commonly-used display types are pages 
and blocks. Any display types added to a view inherit the default settings; however, 
display types can override the default settings if needed. In this way, for example, 
we can create a page display type that shows full nodes, and a block display type 
that shows a table view of just the title. 

This section covers adding display types, and overriding the values set in the 
default display. 
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Chapter 3 


To add a Display type, select a specific type from the drop-down menu, and click the 
Add display button. The most commonly used options are Page and Block, and the 
different options will be discussed throughout the text as they become relevant. 

To begin, we will add a Page display by selecting Page from the drop-down menu and 
clicking the Add display button. 

As shown in the following screenshot, after adding a Page display, you are presented 
with a status message and some specific options for configuring your display. 



As the status message in the preceding screenshot indicates, a Page display requires 
a path, which needs to be set from the Page settings option. 
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Getting Started 


To set the path, click the link in Page settings (shown by Item 1 in the following 
screenshot), and then specify the path (shown by Item 2 in the following screenshot): 



For this example, set the path to bookmarks/all — this will cause the page to be 
visible athttp: / /yoursi te. org/ bookmarks / al I . 

Click the Update button to save the path. 


Adding Multiple Display Types and Overriding Default 
Values 


The same default view can be reused to create multiple display types. In this 
example, we will create a Block display. This will create a Block that we can then 
enable via the Administer | Site building | Blocks link, or via the a d mi n / b u i I d / 
block page. 


[ 



Blocks are covered in more detail in 
Chapter 14: Theming and User Interface Design. 

To emphasize: the block we will create in this section will not be visible 
until we enable it via the ad mi n/bui I d/bl ock page. 


] 
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Chapter 3 


To add a Block display, select Block from the drop-down menu, and click the Add 
display button, shown by Item 1 in the following screenshot: 



For the next step, we need to remove some fields from the block view. 

Given that most blocks are displayed in the sidebar, and that the width 
of a sidebar is limited, you usually want to limit the number of fields in 
blocks to three or fewer. 

To remove fields, click the rearrange icon, shown by Item 2 in the preceding screenshot. 
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Getting Started 


This will show the options seen in the following screenshot: 


© Fields 

Node: Title Title 

Node: Updated/commented date 
Updated/commented date 
Content: Link: Link to Source 

(field_link) URL, as link 

Taxonomy: All terms Keywords 


Items to display: 10 
More link: No 
Distinct: No 
Access: Unrestricted 
Header: None 
Footer: None 
Empty text: None 
Theme: Information 

Block settings 

Admin: None 


Block: Rearrange fields 

© Status: using default values. 

Node: Title Title 

Node: Updated/commented date Updated/commented date 
Content: Link: Link to Source (fieldjink) URL, as link 
Taxonomy: All terms Keywords 


+ U\ 


1 

i 


1 Override | 

® 

. 

,••* ® 

.* o 


| Update] I Cancel 1 


First, click the Override button as indicated by Item 2; this sets specific values 
for the block display separate from the Default display. Then, remove the 

Node: Update/commented date and the Taxonomy: All terms Keywords fields 
by clicking the icons indicated by Item 2. 

A successful edit will look like the following screenshot: 



Click the Update button to save your changes. 

For the final step in editing the Block display, we will edit the Items to display and the 
More link options as shown by Item 3 in the initial Edit View screenshot above. 
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In order to minimize the size of the block, we will set the Items to display to 5, and 
have the block display a More link that points to the page view. These settings will 
display the five most recent bookmarks and a link to the page that displays all stored 
bookmarks. 

To start, click the link next to Items to display. This brings up the options shown in 
the following screenshot: 



Click the Override button to set a different value for the block display. This brings 
up the admin screen seen in the following screenshot: 
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Getting Started 


As you can see in the preceding screenshot by Item 1, after you elect to override the 
default settings the Override button switches to a Use default button. Once you 
have elected to override the default values, set the Items to display to 5, as shown 
by Item 2. 

Click the Update button to save your changes. 

For the final step, we will add a More link to the block. This way, if there are more 
than five bookmarks saved, the block will link to the all bookmarks page. 

To add the link, click the link as shown by Item 1 in the following screenshot: 


Defaults © Block Display the view as a block. 

Page 

Block ► 

I Page v 

[ Add display 1 


[ Analyze ] 


Basic settings 

Name: Block 
Title: None 
Style: Table 
Use AJAX: No 
Use pager: No 
Items to display: 5 
More link: iNoi 
Distinct: No 
Access: Unrestricted 
Header: None 
Footer: None 
Empty text: None 
Theme: Information 


© Relationships + 

None defined 

© Arguments +. iifcJ 

None defined 

© Fields + i&l 

Node: Title Title 

Content: Link: Link to Source 

(field _ link) URL, as link 


[ Remove display"] 
© Sort criteria + Hfcj 

None defined 

© Filters +1**1 

Node: Published or admin 
Node: Type = Bookmark 


Block settings 

Admin: None 


Block: Add a more link to the bottom of the display. 

© Status: using default values. 


I 

| Override 1 


D Create more link 


This will add a more link to the bottom of this view, which will link to the page view. If you have more than one 
page view, the link will point to the display specified in 'Link display' above. 


I Update default display] I Cancell 


As we did earlier, click the Override button as shown by Item 2. Then, select the 
option Create more link as shown by Item 3, and click the Update button to save 
your changes. 
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Chapter 3 


Save Your View! 

Once you have set your defaults and specified the view display, you need to do the 
most important thing: save the view. None of the changes, settings, or configuration 
options are permanently stored until you click the Save button. When you are 
building a view, you should get in the habit of regularly saving the view and then 
returning to it. This ensures that you don't lose any work. 

Creating Views: A Summary 

The Views module exposes an incredible range of functionality. At first glance, the 
amount of options exposed by views can seem overwhelming. At its core, though, 
using the views module involves three central steps: 

1. Add a view 

2. Set up the default view, including adding fields, filters, and arguments 

3. Add display types 

Summary 

In this chapter, we began by exploring our core Drupal install. After taking a look 
around, we began to build our site. 

The process of building our site included examining some steps that we will be 
revisiting frequently as we build our site. These steps include installing contributed 
modules and themes, adding user roles, adding and configuring content types, and 
adding views. Although these tasks have varying levels of complexity, the different 
aspects of site development have some steps that will be repeated as we design 
the site. 

Now, with the foundation in place, we are ready to begin building out a flexible 
platform to support teaching and learning. The first three chapters of this book 
covered the details of making a site live, how the site is organized, and also 
introduced some general Drupal concepts and terminology. 

In the coming chapters, we will continue working with Drupal core and selected 
contributed modules as we build a student and teacher blog. Brew some coffee and 
turn off the phone; it's time to get into it! 
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Creating a Teacher Blog 

This chapter covers the details of creating a teacher blog. In this chapter, you will: 

• Set up a text (WYSIWYG) editor 

• Create two content types: one named teacher blog, and another 
named assignments 

• Assign rights to use the text editor and the new content types 

• Create views to display teacher blog posts and assignments 

As part of this chapter, we will cover adding content into the instructor blog. Once 
finished, this blog can be used to communicate notes, facts, assignments, and other 
information to students, parents, and colleagues. 

It should be noted that the instructions in this chapter cover many administrative 
details required in the setup that, once completed, are rarely touched while using the 
site. The steps covered in this chapter create the tools that will power the instructor 
blog. Many of these steps are done once, and are never carried out again. However, 
taking the time to do them right, and understanding how to go back and adjust 
them, as needed, will ensure that you have the ability to make your site do what you 
need it to do. 


Installing the Text Editor 

To get started using the text editor, navigate to the FCKeditor project page at 
http://drupal. o r g/proj ect/fckeditor. 

Uploading and Enabling FCKeditor 

As described in Chapter 3, download the module, extract the code, and upload it into 
the s i t e s / a I I / mo d u I e s directory. 
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In this site, we are using FCKeditor for the text editor. The support for 
FCKeditor within the Drupal community is solid, which is one of the 
factors to consider when selecting a module. With that said, other options 
that can be used include the WYMeditor, TinyMCE, and BUI editor. 

Unlike most modules, installing the FCKeditor has one additional step: you need 
to download the text editor from the FCKeditor site http://www.fckeditor.net/ 
downl oad.You want to get the current release, which will be listed as shown in the 
following screenshot: 
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Chapter 4 


Download the files from the FCKeditor site, and extract them. Then, as shown in the 
next screenshot, add the new folder to the FCKeditor module code. 



As shown by Item 1 in the above screenshot, the code downloaded from 

http:// www. fckedi tor. net/downl oad goes into si tes/al I /modul es/fckedi tor. 

Once you have uploaded the code, click the Administer | Site Building | Modules 
link, or navigate toadmin/build/modules, and enable the FCKeditor module. 



Click the Save configuration button to finish enabling the module. 

Configuring FCKeditor 

To configure FCKeditor, follow the instructions given in Chapter 3, click the 
Administer link, or navigate to a d mi n , and then click the By module tab, which 
brings you to a d mi n / b y - mo d u I e s. 
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Creating a Teacher Blog 


Alternately, click the Administer | Site configuration | FCKeditor link, or navigate 
toadmi n/setti ngs/fckeditor. 



To configure the FCKeditor, click the FCKeditor link as shown in the preceding 
screenshot. This brings up the administrative screen shown in the next screenshot: 
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Home > Administer > Site configuration 

FCKeditor settings 

There is currently no role with the access fckeditor permission. Visit Permissions administration section. 1 

The FCKeditor module allows Drupal to replace textarea fields with a rich text or WYSIW YG editor. This editor brings 
many of the powerful functionalities of known desktop editors like Word to the web. It's relatively lightweight and 
doesn't require any kind of installation on the client computer. 

More information about the editor is located at the FCKeditor homepage. A small user guide is located at FCKeditor 
userguide. 

Profiles can be defined based on user roles. A FCKeditor profile can define which pages receive this FCKeditor 
capability, what buttons or themes are enabled for the editor, how the editor is displayed, and a few other editor 
functions. It is possible also to define the Global Profile that will hold values that will be appended to all other 
profiles. 

Lastly, only users with the access fckeditor permission will be able to use FCKeditor. 


[more help...] 


Profiles 



Profile 

Roles 

Operations 

Default 


„ edit delete 

2 

Advanced 


edit delete 

Create new profile 



Global Settings 



Profile 


Operations 

FCKeditor Global Profile 


3 edit delete 


Assigning Permissions 

As you can see in the preceding screenshot by Item 1, we get an information message 
letting us know that we have yet to give any role the right to use the text editor. To 
address this, click the Permissions link. 
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Creating a Teacher Blog 


Assigning User Rights via Roles 

Within a Drupal site, individual users can be granted different roles. Within each 
role, the site administrator can assign different privileges. Some of these privileges 
relate to access control, while other privileges relate to accessing functionality. 


In Chapter 3, you created the teacher role. In this chapter, we will assign 
privileges to that role to allow teachers to access FCKeditor, and create 
assignments and teacher blog posts for the teacher blog as needed. Once 
these rights have been tuned, any user granted the teacher role will have 
the rights to run an effective teacher blog. 


Understanding Roles and How They Work 

In a Drupal site, role assignments are cumulative. If a user is a member of two or 
more roles, they have the collected rights of all of these roles. 

Additionally, all users belong to the authenticated user role; this role is frequently 
used to establish basic rights for all users, with more advanced privileges being 
granted via other roles. In this site, we will only assign basic privileges to the 
authenticated user role. The majority of users of the site will belong to either of the 
teacher or student roles that we created in Chapter 3. 


Permission 

anonymous 

user 

authenticated 

user 

site 

admin 

student 

teacher 

fckeditor module 

access fckeditor 

□ 

0 

□ 

□ 

□ 

administer fckeditor 

□ 

□ 

0 

□ 

□ 

allow fckeditor file uploads 

□ 

□ 

□ 

□ 

□ 


As pictured in the preceding screenshot, assign the authenticated user role 
permissions to access fckeditor. Assign the site admin role permissions to 
administer fckeditor. Click the Save permissions button to save the settings. 

Then, when we return to the FCKeditor configuration page by clicking the 
Administer | Site configuration | FCKeditor link, or by navigating to a d mi n / 
setti ngs/fckedi tor, we will have a new information message as shown in the 
following screenshot: 
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Chapter 4 




Not all roles with access fckeditor permission are associated with FCKeditor profiles. As a result, 
users having the following roles may be unable to use FCKeditor: 

o authenticated user 

Create new or edit FCKeditor profiles below and in the Basic setup section, check "Roles allowed to 
use this profile". 


Editing the Advanced Profile 

In this site, we will give all roles access to the Advanced profile. To adjust settings 
for the Advanced profile, click the edit link, as shown by Item 2 in the FCKeditor 
settings screenshot. 

For most uses, the default profile settings will work perfectly. In this example, the 
only setting we need to adjust is in the Basic setup section. 



As shown in the preceding screenshot, allow authenticated users to access 
this profile. 

Click the Update profile button to save the changes. 

The FCKeditor has many settings that can be adjusted, and addressing 
the full range of settings goes beyond the scope of this book. For more 
information, including links to both a Developer's Guide and a User's 
Guide, see http://docs.fckeditor.net. 
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Editing Visibility Settings in the Global Profile 

We will want to make some changes to the FCKeditor Global Profile. To edit this 
profile, click the edit link as shown in the FCKeditor settings screenshot by Item 3. 

We want to adjust the Visibility settings as shown in the following screenshot: 


Home > Administer > Site configuration 

Edit FCKeditor profile 

The Global Profile allows you to define settings that are common for all profiles. Values defined in other profiles will be appended to 
the global configuration. This way you can avoid repeating some of the settings that are usually the same in each profile. 

[more help...] 

D Main setup 

Visibility settings 

Use inclusion or exclusion mode: 

| include jv]] 1 

Choose the way of disabling/enabling FCKeditor on selected fields/paths (see below). Use exclude to disable FCKeditor on selected fields/paths. 
Use include if you want to load FCKeditor only on selected paths/fields. 

Fields to exclude/include: 

2 


Enter names (HTML ID's) of fields that may or may not have an FCKeditor, depending on the chosen option for the inclusion/exclusion 
mode. 

You may separate the different entries by commas, spaces or newlines. 

Paths to exclude/include: 

node/add/* 
node/*/edit ^ 
comment/* 


Enter drupal paths here, depending on the chosen option for the inclusion/exclusion mode. 
Paths may be used the same way as in the drupal blocks configuration. 

You may separate the different entries by commas, spaces or newlines. 

You may also use * as a wildcard character (for example cosrment:/*). 


Force simplified toolbar on the following fields: 


edit-signature 



edit-site-mission 


fit 

edit-site-footer 


vj 



Enter names (HTML ID's) of fields that should have the simplified toolbar. 
If you don't want to use this feature, simply leave this field empty. 

You may separate the different entries by commas, spaces or newlines. 


Force simplified toolbar on the following paths: 


Enter drupal paths that should have the simplified toolbar. 

If you don't want to use this feature, simply leave this field empty. 
Paths may be used the same way as in the drupal blocks configuration. 
You may separate the different entries by commas, spaces or newlines. 
You may also use * as a wildcard character (for example c crane nt/*-). 

[ Update global profile ] 
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Chapter 4 


These settings determine precisely where the text editor will appear. 

As shown in the preceding screenshot by Item 1, set the Use inclusion or exclusion 
mode to Include. 

As shown by Item 2, delete all the values in the Fields to exclude/include text area. 
As shown byitem 3, add three lines to the Paths to exclude/include text area: 
node/add/* 
node/*/edi t 
c o mme n t / * 

Click the Update global profile button to save the changes. 

These settings have the text editor showing up on all forms where a user is adding or 
editing content, or replying to a piece of content. 



Additionally, the text editor can be enabled for specific fields by adding the field 
name into the Fields to exclude/include text area. The names of fields will be 
displayed to users who have the right to administer fckeditor; assigning these 
permissions is shown above, in the Permission screenshot. 


Setting the Proper Input Formats 

Input formats control the HTML tags and other text handling that people can use 
when creating content on your site. Setting your input formats is an essential part of 
running your site securely. 
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Creating a Teacher Blog 


Drupal allows you to grant some users permission to enter either PHP 
code or full HTML tags directly into a post. If these rights are granted at 
\VV all, they should only be granted to a small number of very trusted users, 
as sloppy or malicious use of PHP code or certain HTML tags could 
compromise a site. 

To set the Input formats, click the Administer | Site Configuration | Input formats 

link, or navigate to a d mi n / s e 11 i n g s / f i I t e r s : 


Home > Administer > Site configuration 


Input formats 


List 


Add input format 


Input formats define a way of processing user-supplied text in Drupal. Each input format uses filters to 
manipulate text, and most input formats apply several different filters to text, in a specific order. Each filter is 
designed to accomplish a specific purpose, and generally either removes elements from or adds elements to 
text before it is displayed. Users can choose between the available input formats when submitting content. 


Use the list below to configure which input formats are available to which roles, as well as choose a default 
input format (used for imported content, for example). The default format is always available to users. All input 
formats are available to users in a role with the "administer filters" permission. 


Default 

Name 

Roles 

Operations 


® 

Filtered HTML 

All roles may use default format 

configure ^ 


O 

Full HTML 

No roles may use this format 

configure 

delete 

O 

PHP code 

No roles may use this format 

configure 

delete 


I Set default formaTl 
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Chapter 4 


As shown in the preceding screenshot, click the configure link for Filtered HTML. 



This brings you to the Filtered HTML input format page at ad mi n/setti n g s / 
f i I t e r s / 1 . Click the Configure tab as shown by Item 1 in the preceding screenshot. 
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In the Allowed HTML tags field, as indicated by Item 2 in the above screenshot, 
enter the following list of HTML tags: 

<a> <b> <b I oc kq uo t e > <br> <capt i on> <center> <code> <col> <colgroup> 
<dd> <del > <d i v > <dl> <dt> <em> <f o n t > <hl> <h2> <h3> <h4> <h5> <h6> 
<hr> <i > < i mg > <1 i > <ol > <p> <s p a n > <s t r o n g > <sub> <sup> <t a b I e > 

<t b o d y > <td> <t f o o t > <th> <t h e a d > <t r > <u> <ul> 

Click the Save configuration button to save your changes. 

This list of tags is fairly permissive, and will allow users a great degree of freedom 
over the page layout. It will also work well with the text editor, and will not pose any 
security risks. 



Input filters exist for security reasons, and security is generally balanced 
against ease of use. This list does not contain any of the tags that can be 
used to run malicious code (a.k.a., hack your site), and using the above 
HTML tags you can create tables, change font appearance, and do many 
more things. 


[ For a full list and explanation of HTML tags, look at the tag list from 
W3Schools: http:// www. w3 school s. com/tags/defaul t. asp. 
v> For an overview of HTML tags and security, visit: htt p: / / WWW. 

feedparser.org/docs/ht ml- sanitization,ht ml. 

Now that we have enabled the FCKeditor and created a safe input format, we are 
ready to create the first two content types that will power the teacher blog. 

Creating Content Types for the Teacher 
Blog 

In this section, we will outline how to create two content types used in the Teacher 
blog. This section will refer to the process outlined in Chapter 3. When creating a 
content type you will need to: 

1. Create the content type 

2. Add fields to the content type (optional — not all content types require 
additional fields) 
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3. Assign a taxonomy to the content type (optional—not all content types will 
be organized using taxonomy) 

4. Assign permissions to the content type 


The Blog Post Content Type 

The Blog post content type will be one of the publishing tools available to users in 
this site. To create this content type, click the Administer | Content management | 
Content types link, or navigate to ad mi n/content/types. 

As described in Chapter 3, to create a new content type, click the Add content 

type tab. 

For the Identification section, use the following values: 

Name: Blog post 
Type: blog_post 
Description: Create a blog post. 

In the Submission form settings section, the Explanation or submission guidelines 
can be set to: Create your blog post. Enliven your post with relevant details, and 
describe these details with sumptuous prose. 



The values of the Explanation or submission guidelines are somewhat 
arbitrary; while this section can be used to give instructions, it can also 
be used to have fun. Obviously, the rules of civil and appropriate 
discourse apply, but you can use these instructions to add a touch of 
unexpected flavor. 


In the Workflow settings, set default settings to Published. 

In the Comment settings section, set the default to Read/Write, and configure the 
comment displays as described in Chapter 3. 

Click the Save content type button to create the content type. 


Add Fields 

No fields need to be added to this content type. 


[103] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 







Creating a Teacher Blog 


Assign Taxonomy 

Click the Administer | Content management | Taxonomy, 

or a d mi n / c o n t e n t / 1 a x o n o my. 

As shown in the following screenshot, click the edit vocabulary link for the 
Keywords taxonomy we created in Chapter 3. 



Then, add Blog post to the list of Content types as shown in the following screenshot: 



Click the Save button to save your changes. 

Assign Permissions 

Click the Administer | User management | Roles link, or navigate 
admin/user/roles. Click the edit permissions link for the teacher role. 

Every time we create a new content type, we will need to assign user roles 
permissions to use the content type. The permissions for content types are 
usually assigned via the node module. 
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Permission 


teacher 

node module 

access content 


□ 

administer content types 


□ 

administer nodes 


□ 



0 

create book content 


□ 

create bookmark content 


0 

create page content 


□ 

create story content 


□ 

delete any blog_post content ■ ■ ■ 


□ 

delete any book content 


□ 

delete any bookmark content 


□ 

delete any page content 


□ 

delete any story content 


□ 

delete own blog_post content 


0 

delete own book content 


□ 

delete own bookmark content 


0 

delete own page content 


□ 

delete own story content 


□ 

delete revisions 


□ 

edit any blog_post content •••••• 


□ 

edit any book content 


□ 

edit any bookmark content 


□ 

edit any page content 


□ 

edit any story content 


□ 

edit own blog_post content 


0 

edit own book content 


□ 

edit own bookmark content 


0 

edit own page content 


□ 

edit own story content 


□ 

revert revisions 


□ 

view revisions 


□ 
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Assigning a role the Administer nodes permission will allow all users in 
that role to add, edit, or delete all posts of all content types. Administer 
nodes permissions should only be assigned to highly trusted users. The 
permissions described in this section need to be assigned individually for 
all content types. 


Content types usually have five permissions. For every individual content type, the 
following permissions can be assigned: 

• Create: This permission allows a user to create nodes of a specific content type 

• Delete own: This permission allows users to delete posts they have authored 

• Delete all: This permission allows users to delete any post, regardless of who 
created it. 

• Edit own: This permission allows user to edit posts they have authored 

• Edit all: This permission allows users to edit any post, regardless of who 
authored it. 


As shown in the preceding screenshot, we want to assign the teacher role 
permissions to create blog_post content, delete own blog_post content, and edit 
own blog_post content. 

Click the Save permissions button to save the permissions. 


Hey! Why Not Use the Blog Module? 

Drupal comes with a blog module. Although it could be used for this site, we are 
opting not to use it because of how we are structuring the blog. Unlike more traditional 
blogs, we will be configuring this blog to make it easy to include audio, video, and 
images, as well as text. A person's blog will contain the full range of content they create. 

Additionally, Drupal’s blog module has some features that work better for single 
user or multiple user blogs than for this site. These features include some default 
displays that list all blog posts. For this site, we will be using Views to create 
displays for our content; this allows for a greater degree of flexibility than the blog 
module. So, rather than trying to override the default behavior of the blog module, 
we will sidestep the issue entirely. 


The Assignment Content Type 

To create Assignments, we will create another content type. This content type will 
be very similar to the blog post content type we just created, with one exception: 
Assignments will contain a Date field to allow teachers to specify a Due date. As 
described earlier in this chapter, and in Chapter 3, we need to follow four steps: 
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1. Create the content type 

2. Add fields to the content type (optional — not all content types require 
additional fields) 

3. Assign a taxonomy to the content type (optional—not all content types will 
be organized using taxonomy) 

4. Assign permissions to the content type 

Getting Started: Installing Modules 

To add and display date fields, we need to download and install the Date and 
Calendar modules. Navigate to the project pages for Date and Calendar at 
http://drupal.org/project/date and http://drupal.org/proj ect/cal endar. 

As described in Chapter 3, upload the modules into the sites/all /mo dules directory. 

Then, click the Administer | Site building | Modules link, or navigate to 
admin/build/modules as shown in the following screenshot: 


S7 Date/Time 


Enabled Name Version Description 



Calendar 

6.x-2.x-dev 

Views plugin to display views containing dates as Calendars. 

Depends on: Views (enabled), Date API (enabled). Date Timezone (enabled) 

Required by: Calendar iCal (disabled), Calendar Popup (enabled) 

□ 

Calendar 

iCal 

6.x-2.x-dev 

Adds ical functionality to Calendar views. 

Depends on: Views (enabled), Date API (enabled), Calendar (enabled), Date Timezone 
(enabled) 


Calendar 

Popup 

6.x-2.x-dev 

Replaces the links to calendar items with a javascript popup that gracefully 
regresses if javascript is not enabled 

Depends on: Calendar (enabled). Views (enabled), Date API (enabled). Date Timezone 
(enabled) 


Date 

6.x-2.x-dev 

Defines CCK date/time fields and widgets. 

Depends on: Content (enabled), Date API (enabled), Date Timezone (enabled) 

Required by: Date Copy (disabled) 


Date API 

6.x-2.x-dev 

A Date API that can be used by other modules. 

Required by: Calendar (enabled). Calendar iCal (disabled). Date (enabled). Date PHP4 
(disabled). Date Popup (enabled), Date Repeat API (disabled), Date Timezone (enabled). 
Date Copy (disabled), Calendar Popup (enabled) 

□ 

Date 

Copy 

6.x-2.x-dev 

Import and export CCK date data. 

Depends on: Content (enabled). Date (enabled), Date API (enabled). Date Timezone 
(enabled) 

□ 

Date 

PHP4 

6.x-2.x-dev 

Emulate PHP 5.2 date functions in PHP 4.x, PHP 5.0, and PHP 5.1. Required 
when using the Date API with PHP versions less than PHP 5.2. 

Depends on: Date API (enabled) 


Date 

Popup 

6.x-2.x-dev 

Enables jquery popup calendars and time entry widgets for selecting dates and 
times. 

Depends on: Date API (enabled). Date Timezone (enabled) 

□ 

Date 

Repeat 

API 

6.x-2.x-dev 

A Date Repeat API to calculate repeating dates and times from iCal rules. 

Depends on: Date API (enabled) 


Date 

Timezone 

6.x-2.x-dev 

Needed when using Date API. Overrides site and user timezone handling to set 
timezone names instead of offsets. 

Depends on: Date API (enabled) 

Required by: Calendar (enabled), Date (enabled). Date Popup (enabled), Calendar iCal 
(disabled), Date Copy (disabled). Calendar Popup (enabled) 
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Enable the Calendar, Calendar Popup, Date, Date API, Date Popup, and Date 
Timezone modules. These modules are all part of the Date and Calendar modules. 

If your server has a PHP version below 5.2, you will need to enable 
the Date PHP4 module. To check your PHP version, click the 

Administer | Reports | Status report link, or navigate to 
ad mi n/reports/status. 

Click the Save configuration button to save the settings, and enable the modules. 

The Assignment Content Type 

Navigate to Administer | Content management | Content Types, or a d mi n / 
content/types. Click the Add content type tab. 

For the Identification section, use the following values: 

Name: Assignment 

Type: assignment 

Description: Add an assignment. 

In the Submission form settings section, the Explanation or submission guidelines 
can be set to: Create an assignment. Remember to set a due date. Additionally, you 
can change the Body field label to Description. 

In the Workflow settings, set default settings to Published. 

In the Comment settings section, set the default to Read/Write, and configure the 
comment displays as described in Chapter 3. 

Click the Save content type button to create the content type. 
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Add Fields 

Now that we have created the Assignment content type, we need to add a Date field 
to specify a Due date for assignments. 

As shown in the screenshot below, click the manage fields link. 

Assignment assignment Add an assignment 


We will then Add a New field, as shown in the screenshot below. 

Add 

1 Datetime | Text Field with Date Pop-up calendar v 

Type of data to store. Form element to edit the data. 

Enter the following values: 

Label: Due date 
Field name: due_date 
Field type: Datetime 

Selecting the field type exposes the Form element to edit the data option; select Text 
Field with Date pop-up calendar option. 


+ 

© New field 


field_ |due_date 

Field name (a-z, 0-9, _) 
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Click the Save button. This brings up the final settings screen for Date fields, 
pictured in the screenshot below. 


Due Date Eds Display fields 

Assortment basic information 

Label: 

loubOaw I 

WMpteL type: _ 

I Teet find <wBi Data Poimo flirt w 

[ C lump* banc rdormafron | 


Assortment nettings 

Thrv arttingt appv only 10 the Oum Oom (Mid at * appears m me arafliwnMir mnirnt type. 

Default v«Im>: 

O nl.ank 

® Now 1 

O Relative 

A default V.lue U, me Ioi iSa Held. II you ee‘ect •Relative'. add detafo belo*. 

P Custom?* Default value 

Input format: 

Iimo/aooa- 9 : 4 Spm ua 

Ut the order and I or-vet lor the dele : »*ti hi the input lorm the format renbe adapted to remove -refoae net in the gre«vler«Y for the 

held 

Yoon badt ami forward: 

iW_i 

Number of reart to so both and fvmoid to the year Mdacbon let default ■■ - Ji*J. 

nia 

Increment the msnule and aet u n d Irelde by thee amount. 


f» Customtc Date Parti 



*•> «e» *b» «»«*> 


The ID lor odutng at mludng the aA rmr nl ia: mid deytmedam I be path nr edmaV u mdard/mide type/eeuonment/ledda 
/fl«tlJ_doa_dd«t 


Gfcibji petting* 

Umm setting* aped, to the Out Oats field in every ceotdnt type in wNch 4 appears 



lo IJatr: 

& Nevis 
O Optional 

O Requred 

Oeplat a matth-»g aeeond date Info ee a to date . It marked Vptione' beta ■VI be preoented but rot regurred- If merited Required' the 
to date 1 be moulted * the non date 1 '« re owed or rilled m. 

c*ta'«e-"e the r» awe eetni-s ad am data haa been uyenewud leaull Ml the iuea o« data! 

CromilwHyt 



Sat I 5 ta date elemanda to be aturod (el least e yea* la leoueed). 

DcfeuR Otiplirr 

Date display: 

lll/lO/TOOB ‘IdHpm 

•Custom display format 

I 

t> Additional Display Setting* 

I into rone handling: 

| No tana rone conversion v 

Pales the t.mezene har-dt-ng method te be weed for the date field. 

• The custom I asm el- d onmM. ■* orasnde the eeleiled deldo* or input rsoOona. Del me a oho date format atrtns IVo "srsnl-Y Hif laaa 
http://ohp.net/date for more detale). 

[ save bold detbnot I 
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Chapter 4 


For most uses, including this one, the default settings will work perfectly well. 
However, we want to highlight 6 places on this screen that allow you to customize 
Date fields in order to make them do exactly what you want. 

Item 1; Default Value: set to Now. This will autofill the form with the current time, 
which helps guide users as they fill it out. 

Item 2; Input format: the default value is in military time. In some cases, users are 
more comfortable using AM/PM to indicate times. 

Item 3; Help text: The text here will be shown to users as they are creating 
assignments. For this example, we can use Enter the date and time where the 
assignment will be due. 

Item 4; Required: as all assignments have due dates, we set this to Required. 

Item 5; Granularity: the items specified here will be presented to users as options 
when they create content. For example, if you only want to collect a day, you would 
set the granularity to Year, Month and Day. In this example, as we want to set a 
specific time assignments are due, so we opt to include Hours and Minutes. 

Item 6; Date display: similar to Item 2, above, the default value is in military time. If 
this will pose a problem for your users, set it to a 12 hour time setting. 

Once you have adjusted the settings, click the Save field settings button in order to 
save your changes. 
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Ordering Fields 

After saving your field settings, you will be returned to the Manage fields page. 


Assignment 


I Monage fields 


Display fields 


© Add fields and groups to the content type, and arrange them on content display and input forms. 


Label 

Name 

Type 

Operations 

+ 

Title 

Node module form. 



* 

Due Date 

field_due_date 

Datetime 

Configure Remove 

+ 

Taxonomy 

Taxonomy module form. 




Menu settings 

Menu module form. 




Body 

Node module form. 




File attachments 

Upload module form. 



Add 

* 

© New field 





1 1 

field Q 

| - Select a field type - v | 

| - Select a widget - | 


Label 

Reid name (a-z, 0-9, _) 

Type of data to store. 

Form element to edit the data. 

* 

© Existing field 





1 1 

| - Select an existing field - 

HZI 

| - Select a widget - | 


Label 

Field to share 


Form element to edit the data. 


♦J* © New group 


1 1 

groupJ 

Label 

Group name (a-z, 0-9, _) 


[ Save ] 


The fields can be adjusted via drag and drop. Drag the Due date to be second on the 
page. Click the Save button in order to submit the form and save the changes. 

Assign Taxonomy 

As described in Chapter 3, and earlier in this chapter, use the Keyword taxonomy to 
categorize assignments. 

For a greater degree of control, we can create an additional taxonomy for 
assignments named Type of Assignment. This would allow teachers to apply 
keywords to assignments separate from the keywords used for other content. While 
this is not necessary, increased organization can be useful in larger sites. 
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Chapter 4 


Assign Permissions 

As described earlier in this chapter, assign the teacher role permissions to 

create assignment content, delete own assignment content, and edit own 
assignment content. 

Click the Save permissions button to save the permissions. 

Sample Users and Testing 

Now, we have installed and configured the FCKeditor, created two content types for 
the instructor blog, and assigned permissions to those content types. The next steps 
involves creating a test user for the instructor role, and creating some sample content. 

Adding New Users 

Click the Administer | User management | Users link, or navigate to a d mi n / u s e r / 
user. Click the Add user tab, which brings you to a d mi n / u s e r / u s e r / c r e a t e . 
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When adding a new user, you will need to provide a Username, an E-mail address, 
and a Password. You will also have the opportunity to add the user to a role. When 
adding users, you can also opt to send them an introductory email; the content of 
this email can be edited by clicking Administer | User management | User settings 
link, or by navigating to a d mi n / u s e r / s e 11 i n g s. 

Click the Create new account button to submit the form and create the new 
user account. 

Section Summary 

In the first sections of this chapter, we have set up the basic functionality that will 
power the teacher blog. We have: 

• Installed and configured FCKeditor, and the text editor 

• Installed the modules required to create the teacher blog 

• Created two content types for the teacher blog 

• Assigned permissions to allow users in the teacher role to use the assignment 
and blog content types 

• Added a test user to the teacher role 

To finish creating the teacher blog, we need to complete two remaining steps: 

1. Add some sample blog posts and assignments, and 

2. Create two views; one to display all posts from users in the teacher role, and 
a second view to display assignments. 
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Adding Sample Content 

To begin adding sample content, log in as t e s t _ t e a c h e r, the sample user we created 
earlier in this chapter. 

Once you have logged inastestteacher, click the Create Content link as shown 
in the following screenshot: 
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To add an assignment, click the Assignment link. To add a blog post, click the Blog 
post link. For this example, we will create an assignment. 
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Chapter 4 


To add an assignment, we need to complete the form shown in the preceding 
screenshot; the Add assignment form is what we created earlier in this chapter. 

When you have entered content into the form, click the Save button to save 
your content. 


Iir- - • - . . 

/ 

•>4 Packt and Drupal 


Home 

Search this site: 

|| Search | 

Read and Analyze Chapters 1 and 2 _H Edit 

test_teacher 

Assignment Read and Analyze Chapters l and 2 has been created. 

My account 

t> Create content 

Recent posts 

° Log out 

9 August 2008 • 1:12pm — tcst_teacher 

Due date: 

Thursday, August 14, 2008 l:30pm 

This is a sample assignment. Ideally, this assignment will require critical thinking, and high-level reflection, as 
opposed to rote memorization and repetition. Aim high* 


Add two additional assignments, and two or three sample blog posts. These sample 
posts will allow us to see how the views that we will create in the next section will 
organize and display our content. 

Views for the Teacher Blog and 
Assignments 

Now that we have created some sample content, we are ready to complete the final 
step in creating the Teacher blog: adding a view to display the content types in 
one place. As discussed in detail in Chapter 3, we need to complete three main 
steps to create a view. 

1. Add a view 

2. Set the defaults 

a. Add fields to the view 

b. Add filters 

c. Add arguments 

d. Set style 

e. Set additional configuration options 

3. Add a display type 
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^ Chapter 3 provides a detailed overview of adding views. 

In this section we will create two views: one for the Teacher blog, and a second 
for Assignments. 

The Teacher Blog View 

To get started, click the Administer | Site Building | Views link, 
or navigate toadmi n/bui I d/vi ews. 

Add a View 

Click the Add tab to add a view. 

Enter the following values: 

• View name: teacher_blog 

• View description: All posts to be displayed in the teacher blog. 

• View tag: teacher 

• View type: Node 

Click the Next button to continue. 

Set the Defaults 

Once we have selected the View type and named the view, we can begin setting the 
values for the default view. 

Add Fields to the View 

This view will display full nodes; therefore, we don't actually need to add any fields 
to it. For testing purposes, we will add one field, the Node: Title field. Adding this 
field can be useful if we ever need to troubleshoot a view. 

Once we have added the Node:Title field, we will begin adding Filters. 

Add Filters 

For this view, we will add three filters. The first filter will select only published 
nodes; the second filter will select specific content types; and the final view will select 
only content created by users in the teacher role. 
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To add these filters, we select Node: Published or admin; Node: Type, and 
User: Roles 

When configuring these filters, set the following values: 

Node: Type: Is one o/Bookmark and Blog post 
User: Roles: Is one of teacher 

Node: Published or admin does not have any configuration options. 

Click the Update button to store these values. 

Add Arguments 

This view will not require any arguments; we can move on to setting the Style. 

Set Style 

For the style settings, we will set the Row style. The default value is set to display 
Fields, and we want to display the full post. 
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To set the Row style, click the Fields link shown in the preceding screenshot by 
Item 1. Then, select Node as shown in by Item 2. 

As shown in the Live preview, indicated by the preceding screenshot by 
Item 3, this view is currently only returning Title links. 

Click the Update button; this brings up the configuration options pictured in the 
following screenshot: 




Deselect both options, as shown in the preceding screenshot, and click the 
Update button. 

As pictured in the following screenshot, you can see your options take effect in the 
Live preview pane. In this example, the Live preview has switched from showing 
the list of titles to showing the full posts. 


Title: None 


Node: Type in Blog post. 

Style: Unformatted 

#\ 


Row style: Node 

Use AJAX: No 

Use pager: No 

Items to display: 10 
More link: No 

Distinct: No 

Access: Unrestricted 

Header: None 

Footer: None 

Empty text: None 
Theme: Information 


User: Roles = teacher 


Click on an item to edit that item's details. 


I Save I I Cancel 1 


Live preview 


Display: 

Arguments: 



| Defaults 11 

1 


[ Preview ] 


Separate arguments with a / 

as though they v<ere a URL path. 



Amazing Blog Post 

9 August 2008 - 1:24pm — test_teacher 

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Nunc non tellus. Morbi dolor justo, malesuada eu, 
tempus eget, lacinia ac, massa. In sit amet nunc eget purus tristique tempus. Duis mollis. Curabitur ultricies, 
quam sed posuere aliquet, mauris tellus lacinia pede, ac auctor est eros id risus. Proin at velit at mi suscipit 
ullamcorper. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. 
Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Vestibulum 
mollis. Donee eu dolor. Suspendisse potenti. Fusee orci. Fusee congue elit id felis. 

0 Aliquam enim nibh, posuere quis, dapibus a, pulvinar nec, erat. Aenean laoreet neque sed neque. 
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Now that we have adjusted the style to show full nodes, we also want to set a 
pager for this view. To set a pager, click the Use pager link as shown in the 
following screenshot: 


Use A3 AX: No 
Use pager: jYesi ■ 
Items per page: 10 

More link: No 
Distinct: No 
Access: Unrestricted 
Header: None 
Footer: None 
Empty text: None 
Theme: Information 


User: Roles = teacher 


Defaults: Use a pager for this view 

® Full pager 
O Mini pager 
O No 

Pager element: 

0 

Unless you're experiencing problems with pagers related to this view, you should leave this at 0. If 
using multiple pagers on one page you may need to set this number to a higher value so as not to 
conflict within the ?page= array. Large values will add a lot of commas to your URLs, so avoid if 
possible. 

[ Update 1 [Cancel! 



The difference between a Full and Mini pager are primarily cosmetic; select the 
option that looks best to you, and click the Update button. We are now ready to 
complete the settings for the default view. 

Set Additional Configuration Options 

For this view, we want to provide a meaningful title, and some text in the header to 
provide some context. 

As described in Chapter 3, add a title by clicking the link next to Title in the Basic 
settings section. As shown in the following screenshot, titles are displayed in the 
browser title bar. For this example, use Teacher blog for the title. 
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Next, add some text for the views header by clicking on the link next to Header in 
the Basic settings section. For this view, a simple header will suffice: Hello! You are 
viewing posts from the teacher blog. Enjoy your reading, and comment frequently. 

The final option we need to set for the view default is the Sort Criteria. For this 
example, we will select the Node: Post date option, and set it to sort Descending. 
This will sort the posts in reverse-chronological order, with the most recent posts 
appearing at the top of the view. 

Click the Update button to save the Sort Criteria, and then click the Save button to 
save the view. Next, we will add a display type. 

Add a Display Type 

For this view, we will add a Page display. As described in Chapter 3, select Page from 
the display options drop-down menu, and click the Add display button. 
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Chapter 4 


Once you have added the Page display, shown by Item 1 in the preceding screenshot 
you will be presented with an information message in the Live preview pane shown 
by Item 2. 

As stated in the information message, we need to define a path for the page; we do 
this in the Page settings. 

To define a path, click the None link next to Path in the Page settings. Define the 
path asteacher-bl og, and then click the Update button to store the changes. 

Finally, we will add a menu item by clicking on the No menu link as pictured in the 
preceding screenshot by Item 3. Define the menu as a Normal menu entry, and title 
the menu as Teacher blog. 

Click the Update button to save your changes, and then click the Save button to save 
the view. 

To see the Teacher blog, navigate to the path you defined above; in this example, the 
path ishttp://yoursi te. org/teacher-bl og. 

Remember: None of these configuration changes are permanent until you 
save the view. Updating the values stores the settings, and you can make 
multiple updates as you are in the process of creating or editing the view. 
However, the essential final step is to save the view! 

The Assignment View 

To get started, click the Administer | Site building | Views link, 
or navigate toadmi n/bui I d/vi ews. 

To create this view, we are going to take a shortcut: we are going to clone the 
existing calendar view that comes as part of the calendar module. 

Cloning a view allows us to make an exact copy of it, thus saving us the time and 
effort of having to build the entire view from scratch. 

Some modules come with default views; cloning them and studying how 
they are put together can be a useful method of understanding more 
about how views work. 
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Before we can clone the calendar view, we need to enable it by clicking the Enable 
link as shown in the following screenshot: 


© Default Node view: calendar (Calendar) 

Enable 

Path: calendar 

Calendar block, Calendar block view. Calendar page. Calendar 
page day. Calendar page month, Calendar page week. 
Calendar page year 

A multi-dimensional calendar view with back/next 
navigation. 


Once the view has been enabled, we can clone it by clicking the Clone link as shown 
in the following screnshot: 


© Default Node view: calendar (Calendar) 

Path: calendar 

Calendar block, Calendar block view, Calendar page. Calendar 
page day, Calendar page month, Calendar page week. 
Calendar page year 


A multi-dimensional calendar view with 
navigation. 


Edit | Export | Clone | Disable 
next 


If" 


Once you have chosen to clone the view, you need to rename the cloned copy of 
view, and give it a new description — the first step of adding a new view. For this 
example, we will name the view assignment_calendar; we will change the View 
description to A calendar view of assignments; and we will give it a View tag of 
calendar, assignments. Then, we will click the Next button to begin editing the view. 

Editing the Default Values 

To get the functionality we need, we need to make changes in three sections: 

• Adjust the date field in the Fields section 

• Add filters in the Filters section 

• Adjust the date argument in the Arguments section 

Additionally, we will edit the Title and the Header in the Basic settings section; these 
two additional values to make the view more descriptive and informative for the 
end user. 
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Modifying the Date Field 

The default calendar view that we cloned looks at the date on which a piece of 
content was created. We, on the other hand, are creating an assignment calendar, 
so we care about when the assignment is due. To reflect this, we need to switch the 
posted date to the due date. 

First, we need to add in the due date field from the Assignment content type. To do 
this, click the link to add fields as shown in the following screenshot by Item 1: 


Style: Calendar navigation 

Use AJAX: No 

Use pager: No 

Items to display: Unlimited 

More link: No 

Distinct: No 

Access: Unrestricted 

Header: None 

Footer: None 

Empty text: None 

Theme: Information 


Defaults: Add fields 
Groups: 


© Fields 'H'ffl 

Node: Title Title 
Node: Updated date Upd 
date 

Node: Body Body 


f 


Content 


0 Content: Datetime: Due date (field_due_date) 

t Datetime - Appears in: Assignment 

Content: Link: Link to Source (fieldJink) 

Link - Appears in: Bookmark 


[Add] |Cancel| 
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To find the Due date field we created earlier in this chapter, select the Content filter 
as shown by Item 2. 

Whenever you are adding fields that have been created using CCK, you 
can find them by filtering on Content. 

Then, select the Content: Datetime: Due date (field_due_date) option. Click the Add 
button to add the field to the view. 

Format the display to show a Short date, and click the Update button to store 
your changes. 

Removing the Default Date 

Then, click the rearrange icon as shown in the following screenshot by Item 1: 



Style: Calendar navigation 

Use AJAX: No 

Use pager: No 

Items to display: Unlimited 

More link: No 

Distinct: No 

Access: Unrestricted 

Header: None 

Footer: None 

Empty text: None 

Theme: Information 



Node: Title Title 

Node: Updated date Updated 

date 

Node: Body Body 
Content: Datetime: Due 
date (field_due_date) 
Short 


Defaults: Rearrange fields 


* 

Node: Title Title 


SJ 

* 

Node: Updated date Updated date 

2 — 


* 

Node: Body Body 


® 

* 

Content: Datetime: Due date (field_due_date) Short 


SI 


[Update] [Cancel] 
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Chapter 4 


Then, remove the Node: Updated date field by clicking the remove icon as marked by 
Item 2. Click Update to store your changes. 

Add Filters 

To add filters, click the Add icon in the Filters section, as shown in the 
following screenshot: 



We need to add two filters to this view: Node: Published or admin and Node: Type. 

Set Node: Type to be one of Assignment; click the Update button to store 
your changes. 

Edit the Argument 

To edit the existing argument, click the link in the Argument section as shown in the 
following screenshot: 



This specific date argument brings up the configuration settings as seen in the 
following screenshot. Fortunately, we only need to adjust one minor setting on 
this screen. 
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Chapter 4 


As shown in the preceding screenshot, we need to select the Content: Datetime: Due 
date (field_due_date) option in the Date field(s) section. 

Then, click the Update button to store the settings. 

Adding a Title and Header 

As described earlier in this chapter, and in Chapter 3, we can customize the Title 
and Header in the Basic settings section. For this view, the title should read 
Assignment Calendar. The header should give the user information about what 
they are seeing; for this view, a good header would be: This page shows all 
assignments. Get to work! 

Edit the Calendar Page Display 

To edit the Calendar Page display, click on the Calendar page option. In this 
section, we will edit two settings: the URL path where the view is displayed, and 
the menu settings. 


View assignment_calendar, displaying iti 

Defaults 

Calendar page ► 


Calendar page Calendai 


Yea^vlev^™ 

Month view 
Day view 
Week view 
Calendar block 
Block view 


Page 


a 


[ Add display 


B&sic settings 

mme: Calendar page 
Title: Assignment Cat 
Style: Calendar navigati 
Use A]AX: No 
Items to display: Unlimit 
Distinct: No 
Access: Unrestricted 
Header: Filtered HTMI 
Footer: None 
Empty text: None 
Theme: Information 

Page settings 

Path: calendar 


Setting the Path and Menu 

Both the Path and the Menu can be adjusted within the Page settings section. 


Page settings 


Path: calendar 
Menu: No menu 
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Creating a Teacher Blog 


To edit the path, click the link next to Path. Set the new path to assignment-calendar. 
As described earlier in this chapter, and in Chapter 3, this means that the view will be 
visible athttp: / /yoursi te. org/assi gnment-cal endar. 

Click the Update button so store your settings. 

Then, to set the menu, click the link next to Menu. Set the menu to Normal menu 
item, and give it a Title of Assignment Calendar. 

Click the Update button to store your settings. 

Then, click the Save button to save your view. 

Remember: None of these configuration changes are permanent until you 
save the view. Updating the values stores the settings, and you can make 
multiple updates as you are in the process of creating or editing the view. 
However, the essential final step is to save the view! 

To see the newly-created assignment calendar, navigate to the path we defined above. 
In this example, we set the path to http: / / yoursi te. o r g / assi gnment-cal endar. 




[130] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 





































Chapter 4 


Summary 

In this chapter, the site began to take shape. From an administrative place, we 
installed and configured the FCKeditor, our full text editor. We also got more 
familiar with installing modules, and extended our use of CCK to add the date field 
for the Assignment content type. We also continued to use and experiment with 
views, creating a new view for the Teacher blog and cloning an existing view for the 
assignment calendar. 

You also began to familiarize yourself with roles and access control, an area you will 
explore more fully in the next chapter. 

In the next chapter, we will build on this foundation by adding students into the site. 
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Enrolling Students 

Now that you have created your instructor blog, you are nearly ready to make your 
course interactive. At the risk of stating the obvious, interactions can't happen if you 
are the only member of the course. In this chapter, we will begin enrolling students 
into your class site, and assigning rights to users via roles. 

This process involves two steps: 

1. Assigning rights to the student role 

2. Creating student user accounts 

This chapter covers these two steps, and other details related to personalizing your 
site to create a more welcoming learning environment. 

Understanding Roles, and Assigning 
Rights 

The default Drupal installation comes with two standard roles: anonymous user and 
authenticated user. The anonymous user is used for any non-members visiting the 
site, and anonymous users generally have limited rights on a site used for a learning 
environment. All site members belong to the authenticated user role; consequently, 
any permission granted to the authenticated user role is given to every site member. 
In Chapter 2, we assigned privileges to the authenticated user role. As discussed in 
Chapter 4, the rights assigned to user roles are cumulative; therefore, if a single user is 
assigned to multiple roles, that user has the accumulated permissions of all roles. 

On small sites, some site administrators use the authenticated user role to assign 
permissions to students. From a technical perspective, this will work, but creating a 
specific student role (as we did in Chapter 3) provides an additional level of security 
and flexibility. Later in this chapter we will assign specific rights to the student role. 
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Enrolling Students 


We will leave the authenticated user role with relatively few rights, and assign more 
rights to the student role. When working with students under the age of 18, this added 
level of security can be reassuring to concerned parents. The practice of assigning 
limited rights to the authenticated user role means that even if someone outside of the 
course creates an account on the site, they still won't have the ability to do anything 
until their account has been vetted and approved by a site administrator. 

Additionally, as the site grows, it can be useful to use roles to organize users into 
groups. As an example, let's examine the possibility of inviting parents into the site. 
If the authenticated user role was being used to control the access rights of students, 
then all parents would be able to behave exactly like students within the site. By 
using a separate student role and leaving the authenticated user role untouched, 
parents can be given a different set of rights than their children. 

Unfortunately, Drupal's access rules cannot be similarly extended to govern parent 
behavior in the brick and mortar classroom. 

Assigning Rights 

To assign rights to specific roles, click the Administer | User management | Roles 
link, or navigate toadmi n/user/rol es. 

Rights for the Student Role 

Click the edit permissions link for the student role. 

The rights we will assign to this role will allow us to get students into the site. In 
Chapter 6: Creating the Student Blog, we will begin to assign greater rights to the 
student role to allow them to participate in a broader range of activities. 



As we add the ability to create different types of content on the site, we 
will assign rights to add, edit, and delete that content. In most cases, 
this will be done via the node module, as described in Chapter 3. This 
description will not cover assigning rights to specific content types, as 
these permissions will be discussed in the chapters devoted to these 
specific content types. 
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Assign the following rights to the student role: 

• Comment module: Students do not need approval to post comments. 



As mentioned above, assigned rights are cumulative. The student 
role does not need rights to access or post comments because these 
permissions have already been assigned to authenticated users; 
all users in the student role (and in the entire site) will always be 

authenticated users. 


comment module 

access comments 

□ 

administer comments 

□ 

post comments 

□ 

post comments without approval 

0 


In some sites, teachers want to set up an approval queue for student 
comments. To do that, simply leave the post comments without approval 
checkbox in the preceding screenshot unchecked. However, students are 
more likely to actively participate in an activity when you remove barriers 
\VV. to their participation. Students are used to sites where they can publish 
instantly, and sites that don't meet that expectation are more likely to 
be underused. So, although the permissions allow you to moderate 
comments on a role-by-role basis, in practice, moderating comments can 
chill the conversation. 

• Upload module: Students can upload files, and view uploaded files. To 
configure the file upload settings, including allowed file types, maximum 
file sizes, and size quotas, click the Administer | Site Configuration | File 
uploads link, or navigate toadmi n/setti ngs/upl oads. 


upload module 

upload files 

0 

view uploaded files 

0 


[ 135 ] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 






















Enrolling Students 


• User module: Students can view their classmates' profiles, and change their 
own username. 


user module 

access user profiles 

0 

administer permissions 

□ 

administer users 

□ 

change own username 

□ 


Once these options have been selected, click the Save permissions button at the 
bottom of the page. 

Creating Student Accounts 

For students to be able to participate fully in the course, they need to have accounts 
on the site. Students can either create their own accounts, or a site administrator can 
create these accounts for them (in this case, you can create one for them). 

Creating accounts for the students, as opposed to having students create their own 
accounts, requires more work when setting up your course. However, once your 
course is up and running, there is no difference between these methods. The best 
way is largely a matter of personal preference. 

These instructions cover the default enrolment process, and then describe how to 
customize that process. Details of how to expand and customize student profiles are 
covered in more detail in Chapter 11: Social Networks and Extending the User Profile. 

Method 1: Students Create their Own 
Accounts 

For the following directions, students will complete the initial steps. Once students 
have created their accounts, you will need to assign them into the student role. 

Student Sign-in 

1. On the navigation block, click the Create new account link as shown in the 
following screenshot: 


[ 136 ] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 










Chapter 5 



2. Students will enter a username and an email address. For this example, 
we will create a sample user named jimmy. Once they have entered the 
appropriate values, they should click the Create new account button. 
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Enrolling Students 


3. Once a student has clicked the Create new account button, they will see the 
following message: Your password and further instructions have been sent 
to your e-mail address. 



The registration process can be customized and streamlined, as described 
later in this chapter. For example, you can allow your students to skip 
the email confirmation. Although email confirmation is a useful tool to 
prevent unwanted people from joining your site, in a controlled setting it 
can be an additional and unnecessary step. 


Retrieving the Confirmation Email 

4. Students will need to access their email account to retrieve the confirmation 
email. This email contains an auto-generated password and a link to their 
account page where they can change the password to whatever they want. 
The password fields are located in the Account information section. 


0 Subject Account details for jimmy at Packt and Drupal 
From: bill (gffunn vmonkey. com 
Reply-To: bill(gfunnvmonkev.com 
Date: 7:08 AM 



jimmy. 

Thank you for registering at Packt and Drupal. You may now log in to 

http://www.alphabetademo . com/packt/?q=user using the following username and password: 

username: j iramy 
password: 6iWouMTiRT 

You may also log in by clicking on this link or copying and pasting it in your browser: 
http://www.alphabetademo.com/packt/?q=user/reset/2/1198422493/7769b3f6b0589014e8363badb8e04521 
This is a one-time login, so it can be used only once. 

After logging in, you will be redirected to http : //www.alphabetademo.com/packt/?q=user/2/edit so you 
can change your password. 

Packt and Drupal team 


5. Using the information in the email, students can then log in to the site. 
Students should change their password to something they will remember. 
They can access their account page by following the My Account link 
(pictured in the following screenshot for jimmy). 
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Promoting New Members into the Student Role 

6. As students join the course, you will need to promote them into the student 
role. Click the Administer | User Management | Users link, or navigate to 
admi n/ user / user . 

7. As shown in the following screenshot, select the student(s) you want 
to promote. 
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Enrolling Students 


8. Use the drop-down box to select the student role. 


Update options 


student 


0 


Unblock the selected users 
Block the selected users 
Delete the selected users 
\\Add a role to the selected users 
site admin _ 


Update 


Meml 


teacher 

Remove a role from the selected users 

site admin 
student 
teacher 




2 wet 


—* r\ rv\ i r-i 


9. Click the Update button to assign the user into the new role. 

Method 2: You Create the Student Accounts 

To manually create student user accounts: 

1. Click the Administer | User Management | Users link, or navigate 
to ad mi n/ user / user . Click the Add user tab, which brings you to 
admin/user/user/create. 


If you need to add multiple users, several contributed modules can 
simplify that process. These modules are listed later in this chapter. 

2. Fill out the form with the appropriate values. 


This form allows you to assign users into a role, and provides an option to 
notify the new users with a welcome email. 
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3. Click the Create new account button to submit the form and create 
the account. 

Customizing the Registration Process 

As you are running your course, you will want to control how people join your 
online course. For example, during the beginning of the term, you might want to 
allow anyone to join the site. Then, once the academic year has gotten underway, 
you might want to change the site to only allow new users with site administrator 
approval. These changes are available on the User settings page. The settings on 
this page do not require any changes to run your course effectively. However, these 
settings allow you to create a more personal feel to your course. 
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The User Settings Page 

To access the User settings page, click the Administer | User management | User 

settings link, or navigate toadmi n/user/setti ngs. 

This page has four sections: 

• User registration settings 

• User e-mail settings 

• Signatures 

• Pictures 

User Registration Settings 

You can use these settings to turn registration off after an initial enrolment period. 
If you are allowing students to create their own accounts, you can enable account 
creation with no administrator approval required, and/or no email verification. 
Then, once the initial enrolment period has ended, you can change this setting to 
only allow new users to be added by the site administrator. 



Additionally, you can use these settings to enter specific guidelines to present to 
users upon registering. 
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User Email Settings 

The settings in this section allow you to customize the various notification emails 
that are sent out when users register for the site, forget their password, and so on. 
Customizing these emails help to create a more personal feel to your course, as 
the original email text is fairly bland. The full range of emails is shown in the 
following screenshot: 



Signatures 

Often, in community sites, users can create a customized signature (similar to as they 
can in many email programs) that will automatically be added to the end of the any 
comments they post. Enabling signatures will allow your students to add signatures 
to their comments. 

Pictures 

Within the site, students can be allowed to upload small pictures, or avatars. This 
feature can be allowed or disallowed from the User settings page. 
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Additional Modules for Creating User 
Accounts 

Several other modules exist for streamlining the account creation process. If you 
have a large number of users to manage, or if you are a system administrator at a 
school, you might want to look at these options: 

• Mass account creation and improved user management via the userplus 
module (http: / /drupal . org/proj ect/userpl us). 

• Import users from a csv file: (http: / /drupal . org/proj ect/userj mport). 

• Integrate with Lightweight Directory Access Protocol (LDAP) 

(http://drupal.org/project/ldap_integration). These modules 
include support for mapping LDAP groups to Drupal roles. See also 
http://drupal . org/proj ect/l d a p _ p r o vi si oni ng. 

• To add terms and conditions, or an acceptable use policy, see the Legal 
module (http: / /drupal . org/proj ect/l egal ). 

Summary 

In this chapter, you looked at the main ways of adding students into your site. Now 
that students are in your online course, you have a vastly broader range of options 
available to you. Again, at the risk of stating the obvious, you can't interact within 
your course if you are the only person in the course. In the next chapter, we will start 
these interactions by setting up the student blog. 
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Creating the Student Blog 

In the preceding chapters, we built the framework for our teaching and 
learning platform. 

In Chapter 3, we set up the ability for users to share categorized bookmarks. We 
also added a view that collects and displays these bookmarks in one central location. 
The instructions in Chapter 3 provide a baseline set of instructions for two 
frequently-repeated administrative activities: creating new content types, and 
creating new views to organize and display content. 

In Chapter 4, we created the beginning of the teacher blog. We built on the 
instructions laid out in Chapter 3 to create the two new content types, and to create 
the view to organize and display teacher blog posts. To create an assignment 
calendar for the assignments, we covered how to use a convenient shortcut: cloning 
a view. 

These site-building techniques will be used and referenced as we build out the rest 
of our site. In this chapter, we will add the functionality to power the student blog; 
in Chapter 7, we will take a look at how these different pieces fit together. Then, in 
Chapters 8 to 13, we will look at more advanced functionality: adding images, audio, 
video, tracking student responses to assignments, and managing multiple classes. 

As discussed in Chapter 4, blogging in Drupal encompasses a range of learning 
activities. When incorporated into a course as a regular part of the coursework, blogs 
provide an incredibly powerful means of tracking student growth. For students who 
are disorganized (that is, students whose backpacks resemble tumbleweed), the blog 
can also be an organizational tool. Most importantly, though, blogs create a record of 
student work that can be accessed at any time. As such, blogs provide a convenient 
window into both process (how students work) and product (the end results of 
student work). 
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Setting Up the Student Blog 

In Chapter 4, as we set up the teacher blog, we created a blog post content type, and 
a view to display the teacher blog posts. To create the student blog, we need to do 
two things: 

1. Give users in the student role permissions over the blog post content type; 

2. Clone the teacher_blog view, and edit it to display student blog posts. 

Assigning Permissions 

To allow students to blog in the site, we need to allow users in the student role the 
ability to create blog posts. Click the Administer | User management | Roles link, 
or navigate to admi n/user/rol es. Click the link to edit permissions for the 
student role. 

For additional reference on assigning rights to content types, 
see Chapters 3 and 4. 

Navigate down to the section for the node module. Select the options for create 
blog_post content, delete own blog_post content, and edit own blog_post content. 

Click the Save permissions button to save the settings. 

Students can now blog in the site. 

Clone the Teacher Blog 

Now that students have the ability to create blog posts, we now need to create 
a central place where people can read these posts. We have already set up this 
structure for the teacher blog; cloning this pre-existing view will allow us to quickly 
replicate this structure for the student blog. 

^ \VV The process of cloning a view is also discussed in Chapter 4. 
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Chapter 6 


To begin, click the Administer | Site building | Views link, or navigate to 

ad mi n/bui I d/vi ews. Scroll down to the teacherjblog view and click the Clone link. 



Change the view name to studentjblog; change the view description to All posts to 
be displayed in the Student blog; change the View tag to student. Click the Next 
button to continue. 

In the default settings, we want to change the User: Roles filter. As shown in the 
following screenshot, you can verify that you are editing the Defaults as indicated 
by Item 1; to edit the User: Roles filter, click the link as indicated by Item 2; and to 
edit the Title, click the link indicated by Item 3. 


View student_blog, displaying items of type Export Clone View "Page" New view 
Node. ^ “\ 


Defaults * ► 

© Defaults Default settings for this view. 

Page 

View settings 

© Relationships 

+jn 

© Sort criteria + tf 


Tag: student 

None defined 


Node: Post date desc 

] Page v| 



1 Add display I 

Basic settings 

Name: Defaults 

© Arguments 

None defined 


© Filters +lf*l 

Node: Published or 
admin 

Node: Type in Blog post, 


Title: Teacher blog^« 
Style: Unformatted 



I Analyze | 

Row style: Node ifr 

Use AJAX: No 

Use pager: Yes 

Items per page: 10 

More link: No 

Distinct: No 

Access: Unrestricted 
Header: Filtered HTML 

Footer: None 

Empty text: None 

Theme: Information 

^3 


User: Roles = teacher 

▲ 




2 


Click on an item to edit that item's details. 
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Change the User: Roles setting to student; this will only select content posted by 
users in the student role. Change the Title setting to Student blog. 

As we add more content types (audio, video, and images) we will need 
to revisit this view to update the Node:Type filter. At this stage, this filter 
only selects blog posts and bookmarks. 

Then, as shown in the following screenshot, click the Page link (indicated by Item 1) 
to change the settings for the Page display for this view. We need to edit both of the 
options under Page settings (indicated by Item 2). We also need to edit the Header 
(indicated by Item 3) in the Basic settings. 



View student_blog, displaying items of type 


Export Clone View "Page" New view 



Page 


m 


I Add display 


Analyze 


6 Page Display the view as a page, with a URL and menu links. 


Basic settings 

Name: Page 
Title: Student blog 

Style: Unformatted # 
Row style: Node 
Use AJAX: No 
Use pager: Yes 
Items per page: 10 
Distinct: No 
Access: Unrestricted 
Header: Filtered HTML 
Footer: None 
Empty text: None 
Theme: Information 

Page settings 

Path: teacher-blog 
Menu: Normal: Teacher 


© Relationships 

None defined 

© Arguments 

None defined 


+ n 


+ n 


[ Remove display | 
© Sort criteria + ff 

Node: Post date desc 

©Filters + 

Node: Published or 
admin 

Node: Type in Blog post, 
User: Roles = student 


Click on an item to edit that item's details. 


Under Page settings, change the Path to student-blog, and change Menu to Normal: 
Student blog. 

Under Basic settings, edit the Header to read Hello! You are viewing posts from the 
student blog. Enjoy your reading, and comment frequently. 

Click the Save button to save the view. 

All student blog posts are now visible at http: / /yoursi te. org/student-bl og. 
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Getting Interactive 

Now that students can create blogs in the site, you have the ability to foster dialogue 
within your class. The easiest way, of course, is simply through commenting. 
Students have the rights to comment on assignments, and on teacher and student 
blog posts. However, students might also want to reference other pieces of content in 
their work. In this section, we will set up a mechanism that will keep track of when 
one post within the site references another post within the site. This way, people can 
see when exchanges are occurring about different posts, and it provides another way 
(in addition to comment threads) for people to hold discussions within the course. 

These ideas (including tracking student responses to assignments) are covered in 
more detail in Chapter 13: Tracking Student Progress. 

Seeing Who's Discussing What 

Within the site, we will want to see who is discussing what posts. In web parlance, 
this is referred to as a backlink. Fortunately, the Views module comes with a means 
of tracking backlinks by default. We will clone and customize this existing view to 
get exactly the functionality we want. 

The process of cloning this view includes the following steps: 

• The default backlinks view needs to be enabled and cloned. 

• In the cloned view, the different displays need to be edited: 

0 In the Default display. Fields need to be added to the view, 
the Arguments need to be adjusted, and the Empty text needs 
to be deleted. 

0 As the new view will only generate a block, the Page display 
should be removed. 

° In the Block display, the Items per page needs to be 

increased, the More link needs to be removed, and the Block 
settings needs to be changed. 

• Then, once the new view has been saved, the block created by this view 
needs to be enabled. 
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Enabling and Cloning the Backlinks View 

To get started, click the Administer | Site building | Views link, or navigate to 
a d mi n / b u i I d / v i e ws . As shown in the following screenshot, enable the default 
backlinks view. 



Once we have enabled the backlinks view, we want to clone it. So, we click the 
Clone link. 

Change the View name to conversations, and change the View description to 
Cloned from default "backlinks" view; displays a list of nodes that link to the 
node, using the search backlinks table. The View tag can be left blank. 

Click the Next button, which brings us to the Edit page for the view. 

Editing the Default Display 

As shown in the following screenshot, we will make four main edits to this view. 
We will add Fields, adjust the Arguments, delete the Empty text, and remove the 
Page display. 
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Chapter 6 


Adding views is introduced in Chapter 3, and cloning views is introduced 
in Chapter 4. 

To add Fields, click the + icon as indicated, in the preceding screenshot, by Item 1. 
Add three fields: Node: Post Date; Node: Type; and User: Name. Click the Add 
button, and then configure the new fields to your preferences. 

Next, edit the Arguments by clicking the Search: Links to link as indicated in the 
preceding screenshot by Item 2. We will edit the argument handling as shown in the 
following screenshot: 
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Select the options to only validate for Blog posts and Bookmarks. Additionally, 
check the option for Validate user has access to the node. 



These argument settings confirm that we are only checking for backlinks 
on Blog posts and Bookmarks. As we add more content types (for 
audio, video, and images) we will need to update this view to check for 
backlinks on these additional content types as well. We will also use a 
version of this view in Chapter 13: Tracking Student Progress. 


Click the Update button to store these changes. 

Then, we will remove the Empty text by clicking the Filtered HTML link as 
indicated by Item 3 in the screenshot just above the preceding one. Delete the existing 
empty text string, and click the Update button to store the changes. 

Deleting the empty text makes it so the view will not be displayed if the 
view returns no content. Although this would not be useful on a Page 
display, it is useful for a Block display, as this hides the block when there 
is nothing to show. 



Remove the Page Display 

As shown by Item 4 in the screenshot just above the preceding one, click the link to 
show the Page display type. 


View conversations, displaying items of type Node. Export Clone New view 


Defaults 

© Page Display the view as a page , with a URL and menu links. [ Remove display ] 

Page ► 


Block 

Name: Page None defined None defined 

Title: None 

Sty * 61 List ** ©Arguments + ** ©Filters + f >J 

Row style. Fields jjL Search: Links to Node: Published True 

Use AJAX: No 

Use pager: Yes . _ 


| Page v | 

1 Add display I 


We are going to be displaying the backlinks in a block, and will not need the Page 
display. Therefore, we want to remove it by clicking the Remove display button as 
shown in the preceding screenshot. 

Once we have clicked the Remove display button, click the Block link to edit the 
Block display. 
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Chapter 6 


Edit the Block Display 

When we are editing the Block display, we will need to edit three values. 


Block 


Page 


3 


Add display 


Analyze 


Basic settings 

© Relationships 

+Jb 

© Sort criteria + it* 

Name: Block 

Title: None 

None defined 


None defined 




Style: List JSLl 

Row style: Fields J5L 

Use AJAX: No 

Use pager: Yes 

Items per page: 6 1 

More link: Yes 2 

Distinct: No 

© Arguments 

Search: Links to 

jtilij 

©Filters + It*l 

Node: Published True 




© Fields + 1**1 

Node: Title 

Node: Post date Post date 


Access: Unrestricted 

Node: Type Type 



Header: None 

User: Name Name 




Footer: None 

Empty text: Filtered HTML 

Theme: Information 

Block settings 

Admin: What links here 3 


Click on an item to edit that item's details. 


Change the Items per page option (as indicated by Item 1 in the preceding screenshot) 

to 10. 

Change the More link option (indicated by Item 2) to No by unchecking the Create 
more link checkbox. 

Change the Admin text under the Block settings option (indicated by Item 3) 
to conversations. 

Click the Save button to save the view. 

Then, return to Administer | Site building | Views link, or navigate to 
ad mi n/bui I d/vi ews, and disable the default backlinks view. Although we 
used it as a starting point, we now have no further need for it; therefore, we 
can disable it. 

Enabling the Block 

As a result of the modifications we have just completed for our new view, we 
created a block that will display any backlinks when we are looking at Blog posts or 
Bookmarks. For the final step, we will enable our new block. 
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Creating the Student Blog 


Click the Administer | Site building | Blocks link, or navigate to 
ad mi n/bui I d/bl ock. 

We named this block when we adjusted the Block settings as shown in the preceding 
screenshot by Item 3. The value of the Admin text, which we set to conversations, is 
the name of the block. 

To display the block, use the drop-down menu to select the desired region. 



Disabled 


configure 

configure 

configure 

configure 


4* conversations" 

<none> 


4* Author information 

Left sidebar 

Right sidebar 


Content 

Header 

Footer 

<none> 


4* Book navigation 
4* Calendar Legend. 


Select Right sidebar, and then click the Save blocks button at the bottom of the page 
to save the settings. 

Blocks, and their role in creating an intuitive navigational structure, are 
covered in more detail in Chapter 14: Theming and User Interface Design. 



Seeing It Work 

In this chapter, we have built the framework for the student blog, and started 
to build out the functionality that will support various types of interaction and 
discussion between people on the site. Now that we have built out this functionality, 
it's time to see how it fits together. 



The backlinks functionality uses the site's search index to track links. The 
search index gets updated when cron jobs are run. We will discuss how 
to automate cron jobs in Chapter 15: Backup , Maintenance, and Upgrades. 
Until cron jons are automated, you can run a cron job manually by 
navigating to http: / / your si te, o r g / cron, php when logged in as a 
site administrator. If your backlinks are not showing (or any time search 
gives you unexpected results) triggering a cron job manually can help 
resolve the issue. 
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Chapter 6 


In this section, we will add some sample content to illustrate the functionality we 
have just built. To start, add some sample student users as described in Chapter 5. For 
this example, we will add two new students — lucy and helen. 

We will then log in as helen and create two new blog posts. Helen's first post is 
shown in the following screenshot: 



Copy the URL into your clipboard, and then, while still logged in as helen, create 
another blog post. 
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Creating the Student Blog 


When creating this second post, add a link to Helen's first awesome blog post. 



To add the link, highlight the text you want to be the hyperlinked, and then click 
the link icon, indicated by the arrow in the screenshot above. Paste the URL into the 
Link form, and then click the OK button. 

Finally, submit the post. 
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Chapter 6 


Next, log out, and log back in again as lucy. As shown in the following screenshot, 
lucy will click the Student blog link to see what her classmates have been writing. 
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Creating the Student Blog 


Lucy will read Helen's first awesome blog post, and after being inspired or 
motivated by helen's post, lucy will create her own post where she links back to 

Helen's first awesome blog post. 
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Chapter 6 


At this point, both helen and lucy have linked to helen's first post. When we navigate 
to this, we will see a screen which looks like the following screenshot: 



The What links here block that we created earlier in the chapter shows all posts 
within the site that link back to this blog post. This allows site members to 
communicate with one another through comments, or through their own blogs. 
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Creating the Student Blog 


Summary 

In this chapter we created the foundation that will support both teacher-led and 
student-led led interaction. The instructor blog, appearing on the home page of the 
site, can give structure to the class and provide guidance to students. The student 
blogs, collected and displayed via the view we created, provides a place for students 
and teachers to see each other's work, and to provide feedback via comments. 

In the upcoming chapters, we will learn how to use the blog to share audio, video, 
and pictures. The upcoming chapters will also demonstrate how these different 
media types can be used in concert to provide support for organized, structured, and 
student-led inquiry. 
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Bookmarks 


Bookmarks, at their most basic, allow site users to store, categorize, and share links 
to websites. Bookmarks can also be used as a tool for focusing student discussions, 
and as a means to teach media literacy and critical evaluation of sources. In this 
chapter, we will discuss how to store bookmarks on your website, and describe some 
activities that incorporate bookmarks into the daily work of the class. 

In Chapter 3, we created a bookmark content type using the Link module. In 
Chapter 4, when we created the Teacher blog, we set up the view that collects the 
Teacher blog posts to include bookmarks. In Chapter 6, when we set up the Student 
blog, we configured the views that collect Student blog posts and backlinks to include 
bookmarks. To complete the process, we need to assign rights to users in the student 
role to create bookmarks. 

In Drupal, there are several ways to create bookmarks. In this 
book, we use CCK and the Link module, as this aligns with how 
we are creating other content types. This also has the advantage of 
making our bookmarks searchable. However, for those looking for 
r-Sy/ different ways to create bookmarks, look at the Bookmarks module 
at(http: / /drupal . org/proj ect/bookmarks)or the Weblinks 
module at (h 11 p: / / d r u p a I . org/proj ect/webl i nks). Both of 
these methods work, and if you are looking to create a site focused more 
exclusively on sharing and displaying bookmarks, one of these solutions 
might meet your needs. 


Assign Rights to Use Bookmarks 

Click the Administer | User management | Roles link, or navigate to a d mi n / u s e r / 
r o I e s . Click the edit permissions link for the student role. Scroll down to the rights 
for the node module; assign students the right to create bookmark content, delete 
own bookmark content, and edit own bookmark content. 
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^ Assigning privileges is covered in more detail in Chapter 3. 

Click the Save permissions button to save the updated permissions for the 
student role. 

Now, both students and teachers have the rights to create bookmarks, and all stored 
bookmarks will show up in user's blogs. 

Using Bookmarks in the Classroom 

The most traditional use of bookmarks in the classroom involves storing a link to a 
useful resource, and categorizing that link with descriptive keywords. 

While bookmarks are a useful tool on their own merit, they can also be used to 
support other methods of teaching and learning. Bookmarks can be used to focus 
online and face-to-face (f2f) conversations, as an extended tool to support note 
taking, and as a tool for teaching media literacy. 

Depending on the context, a bookmark can range from an online Postlt to a more 
formal resource used as a central point in structured lessons. In this section, we will 
examine some methods of using bookmarks within a class setting. In future chapters, 
we will discuss how bookmarks can provide a useful starting point for research as 
part of larger projects. 

Sharing a Bookmark 

To add a bookmark to the site, click the Create Content | Bookmark link, or 
navigate tonode / add / bookmar k. 

For this example, we will add a link to a Wikipedia article on Moby Dick (the novel by 
Herman Melville) as pictured in the following screenshot: 
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Bookmarks 


Once you have entered the appropriate Title, Link, Keywords, and Body description, 
click the Submit button. The following screenshot shows the saved link: 



Bookmark to Blog 

Bookmarks can also be used as a starting point for student conversations via the 
student blog. By providing students a link to a common resource, you can use 
bookmarks as tools to structure pre-teaching, or to support student-directed inquiry 
through content. 

To get started, log in as a user in the teacher role. 

Create a bookmark, as described above, pointing to h 11 p : / / www, pthompson, addr, 
co ml mo by/advice, htm. This site gives very general instructions to readers starting 
Moby Dick. 

Use these keywords to describe the post: Moby Dick, Reading Moby Dick, 
evaluating bookmarks 

When we use keywords to describe a post, we are using Drupal's core 
taxonomy functionality. When we add keywords to a post, we will also 
refer to it as"tagging a post" or "categorizing a post". 

Then, create an assignment (by clicking the Create content | Assignment, or by 
navigating to node / add / assi gnment) that links to the newly-created bookmark. 
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In the Body field, ask the following questions: 

1. What elements of this site help create the impression that the author is a 
reliable source of information? 

2. What elements of this site detract from the author's reliability? 

3. Does the author appear to have any biases? 

4. In order of importance, list the criteria you use to rate a site's/author's 
credibility? For example, do you look at spelling before looking at the 
date a page has been updated? What elements of a site do you examine in 
evaluating the information you are reading? 

5. Is this page a useful resource? For whom? Explain and support your 
opinion. 

Create a blog post where you respond to these 5 questions. Tag your blog 
post with the keyword "evaluating bookmarks". 
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Now, if we look at the original bookmark, we will see the assignment alongside it. 


Home 

Some general advice on reading Moby Dick 

| Edit 

4 September 2008 - 9:32am — test_teacher 
A general resource on reading Moby Dick. 

Link to Source: 

http://www.pthompson.addr.com/moby/advice.htm 

evaluating bookmarks Moby Dick Reading Moby Dick 


What links here 

Media Literacy: Evaluating 
sources 

Post date: 09/04/2008 - 
9:36am 

Type: Assignment 
Name: test teacher 


[ In Chapter 13: Tracking Student Progress, we will describe how to 

* track responses to assignments. Also, as noted earlier, the backlinks 
functionality requires cron jobs to be set up. Cron jobs are covered in 
detail in Chapter 15: Backup, Maintenance, and Upgrades. 

Learning Goals 

This exercise accomplishes the following goals: 

1. Students gain an increased sense of how to use keywords/tags to organize 
their work, and connect with the work/thoughts of others. 

2. Students begin, or continue, to develop the habit of thinking critically 
about websites. 

3. Students gain an increased familiarity with a vocabulary focused on media 
literacy and critical evaluation of resources. In many cases, these topics will 
dovetail with existing teaching practice within English and history curricula: 
identifying authorial bias and intent, identifying the target audience, 
identifying best practice with citation, and so on. 

4. Students and teachers begin to see how the different tools can be connected 
to support learning activities. Using the technique of a bookmark to lead into 
a reflective blog post can be used to support an almost limitless number of 
teaching and learning activities. The context of the student response is set 
by the subject of the initial bookmark, and follow-up questions can be used 
to provide a context for a focused blog response. If activities such as this are 
used as part of a homework assignment, a teacher can read these assignments 
prior to class with an increased sense of what the class understands, and 
where they need additional support. 
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Bookmarks and Media Literacy 

Bookmarks can also be used, as in this example, as a tool for developing media 
literacy. Focused questions that guide students to analyze the various elements of a 
web page help students develop the critical thinking skills and vocabulary needed to 
articulate the strengths and weaknesses of the content they encounter online. 

Bookmarks as Part of Ongoing Student 
Research 

Bookmarks could also be used as a tool in ongoing research. For example, in a unit 
covering Moby Dick, students need to include a bookmark per chapter that explains 
an allusion or symbol from the reading. For lower-level classes or classes needing 
more structure, students could be assigned specific allusions. For upper-level classes, 
students could select the allusions they want to research based on personal interest. 
In a text like Moby Dick, students could be assigned allusions/symbols based on 
specific topic areas: for example, one set of students could be assigned to store 
bookmarks referencing Biblical allusions, while another set of students could be 
assigned to allusions about American politics, and so on. 

As the course unfolds, the student bookmarks will provide a repository of 
categorized links. As a teacher, you can refer to these links during class discussions, 
or even plan lessons around the links shared by your students. If you have students 
submit links as part of their homework assignments, you can open the class by 
having an icebreaker conversation where students explain why they chose to include 
a specific link. 

Learning Goals 

By incorporating the student-generated links into your classroom plan you can 
achieve several goals: 

1. As students create resources that become incorporated into the daily work 
of the class, they get the opportunity to view themselves (and their peers) as 
active participants in their learning environment. 

2. By using student-generated links to spark discussion, you reinforce the 
notion that all participants in the course (students and teacher) have a role to 
play in creating course content. 

3. By requiring ongoing research and providing a structure within which 
students can share items they find during this research, you help students 
develop the skills needed for self-directed learning. 
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4. Sharing resources allows another venue for students to contribute to the 
course discussion. Frequently, students who do not enjoy class discussions 
can use online tools such as blogs and bookmarks to contribute to the 
discussion in a less direct way. Successful online interactions within the 
course space can lead to more active participation within the face-to-face 
class meetings. 

Summary 

Bookmarks are an informal way for students to contribute material into the course 
space. The informal nature of the bookmark can be less daunting to students learning 
how to work in an online environment. Additionally, bookmarks provide a means of 
supporting other types of learning within the site. In future chapters, we will build 
on the strategies described in this chapter to use the different content types within a 
Drupal site to support student inquiry. 
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Podcasting and Images 


Podcasting allows you to share audio files over the Internet. In recent years, as 
podcasting has increased in prominence and popularity, there has been an almost 
overwhelming amount of information about how to get started with podcasting: the 
technical requirements, the hardware, the software, and so on. 

Sharing images creates a variety of ways for students to get involved in the class. In 
some classes, such as Photography or other Fine Arts courses, images provide a way 
for students to showcase their work. In other courses, online image sharing can be 
used to enhance the curriculum. 

In this chapter, we will focus on cutting through the noise, and setting up your site 
to work as a podcasting and image sharing platform. This chapter will break down 
the technical aspects of publishing audio and images, along with ways of integrating 
podcasting into your class. 


Getting Started with Podcasts 

To create a podcast, you will need: 

1. an mp3 file 

2. a place to store the mp3 file 

At the risk of stating the obvious, a good podcast requires thought and planning 
before you make the actual recording. Later in the chapter, we will discuss some of 
these general mechanics. But, from a technical perspective, once you have your audio 
file, you can upload it to your Drupal site, and you will have published a podcast. 
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Audio Module 

The Audio module supports the playback of audio files that have been uploaded 
to your site. To install this module, we will also need to install two helper modules 
required by the Audio module: the getID3() and Token modules. 

In this section, we will cover installing the Audio module, as well as the getID3() 
and Token modules. 

Install the getlD3() Module 

Download the getID3() module from http://drupal . org/proj ect/geti d 3 , and 
upload it to your s i t e s / a I I / mo d u I e s directory, as described in Chapter 3. 

Do not, however, enable the module, as we need to install an additional piece of code 
described as follows: 

Install the getlD3() Libraries 

The getID3() libraries are a tool that automatically extract information about audio 
files. These libraries don't require you to do any additional work; rather, they detect 
information that can be used by the Audio module. 

Download the getID3() libraries from http://getid3.sourceforge.net/. Unzip these 
libraries onto your hard drive. 
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[c 

Then, use your FTP client to connect to your web server, and navigate to 
sites/ali/modules/getid3. Upload the getid3 directory into sites/all/modules/getid3 
as shown in the following screenshot: 


As shown in the preceding screenshot, the libraries include some demo 
and helper files, in addition to the readme and license files. The only files 
we need are contained in the getid3 directory. The getid3 directory is the 
only directory that you need to upload to your website. 



Once the module and the libraries have been uploaded to your site, enable the 
getID3() module by clicking the Administration | Site building | Modules link, 
or by navigating to a d mi n / b u i I d / mo d u I e s. 

Following these instructions the path to your getID3() library is 

sites/all/modules/getid3/getid3. If needed, this path can be adjusted at 

Administer | Site configuration | getID3(), or ad mi n/setti ngs/geti d 3. 
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Install the Token Module 

Download the Token module from http: / / d r u p a I . o r g / proj ect/token, and 
install it as described in Chapter 3. Once this module has been uploaded to your 
site, enable it by clicking the Administration | Site building | Modules link, or by 
navigating to a d mi n / b u i I d / mo d u I e s. 



The Token module is a helper module, and its functionality will be 
largely invisible to the end user. The Token module supplies pieces 
of text, or tokens, which can be used by other modules. The Audio 
module relies on the Token module and the getID3() module to help 
automatically generate titles and other information for audio files. 


Install and Enable the Audio Module 

Download the audio module from http://drupal . o r g / proj ect/audi o. 
Upload the module to your sites/all/modules directory, and enable it by 
clicking the Administer | Site building | Modules link or by navigating to 
ad mi n/ b u i I d/ modul es. 

Select the Audio and the Audio getID3 modules. 

Click the Save configuration button to submit the form and enable the modules. 


Configure the Audio Module 

Now that we have installed the Audio module and its helper modules, we need to 
configure the audio module to support our needs. 

Click the Administer | Site Configuration | Audio link, or navigate to 
admin/settings/audio. 

As pictured in the following screenshot, you will see three tabs across the top of the 
page: Audio, Metadata tags, and Players. 
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Home > Administer > Site configuration 


Audio settings 


Audio 


Metadata tags 


Players 


The current PHP configuration limits file uploads to 8 MB. 

There are two PHP ini settings, upload_max_filesize and post_max_size, that limit the maximum size of 
uploads. You can change these settings in the php.ini file or by using a php_value directive in Apache 
.htaccess file. Consult the PHP documentation for more info. 


[more help...] 


Default node title format: 


The audio node's title can use the file's metadata as variables. This will be used as the default title for all new audio 
nodes. By using the tokens listed below, you can automatically create titles from things like a song's artist or title. Note: 
the node title is escaped so it is safe to use the -raw tokens. 

Node teaser format: 

| [audio-player]<br />[audio-length] | 

Use this setting to customize the teasers for audio nodes. Using the tokens listed below you can select what information 
about the file will be displayed. Note: the teaser is not escaped so it is unsafe to use the -raw tokens. 

D List of available tokens 

Permitted audio file extensions: 

|mp3wavogg [ 

Audio file extensions that users can upload. Separate extensions with a space and do not include a leading dot. 

0 Downloadable by default 

Check this to make downloadable the default setting for new audio nodes. You should be aware that even when audio is 
not marked as downloadable, clever users can still download it, this just makes the work harder. 


[ Save configuration ] [ Reset to defaults"] 


The Audio Tab 

The options on the Audio tab, pictured in the preceding screenshot, allow you to set 
some default values that are used when audio posts are uploaded. The values here 
can be created automatically, which can be useful if you are working with songs. For 
most cases, however, you will want to delete the option for the Default node title 
format, and leave the other default values intact. 
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When you have adjusted the settings, click the Save configuration button at the 
bottom of the page. 

[ -sy * To save your settings, you must click the Save configuration button 1 

before moving on to the next tab. 1 

A Brief Explanation of Tokens 

In the preceding screenshot, there is a collapsible fieldset titled List of available 
tokens. Click on the link to expand the fieldset. A portion of the tokens available are 
shown in the following screenshot: 


Token 

Replacement value 

Node tokens 

[nid] 

Node ID 

[type] 

Node type 

[type-name] 

Node type (user-friendly version) 

[language] 

Node language 

[title] 

Node title 

[title-raw] 

Unfiltered node title. WARNING - raw user input. 

[author-uid] 

Node author's user id 

[author-name] 

Node author's user name 

[author-name-raw] 

Node author's user name. WARNING - raw user input. 

[author-mail] 

Node author's e-mail. 

[author-mail-raw] 

Node author's e-mail. WARNING - raw user input. 

[term] 

Name of top taxonomy term 

[term-raw] 

Unfiltered name of top taxonomy term. WARNING - raw user input. 

[term-id] 

ID of top taxonomy term 

[vocab] 

Name of top term's vocabulary 

[vocab-raw] 

Unfiltered name of top term's vocabulary. WARNING - raw user input. 

[vocab-id] 

ID of top term's vocabulary 

[yyyy] 

Node creation year (four digit) 

[yy) 

Node creation year (two digit) 

[month] 

Node creation month (full word) 

[mon] 

Node creation month (abbreviated) 

[mm] 

Node creation month (two digit, zero padded) 

[m] 

Node creation month (one or two digit) 

[ww] 

Node creation week (two digit) 

fdatel 

Node creation date fdav of month} 


As suggested by the preceding screenshot, tokens expose pieces of information 
about content created within a site. Tokens can only be used when a module has 
been written to work with the tokens. Because the Audio module has been written 
to depend on the Token module, we have the option of using tokens if we wish. 
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For example, we could set the title of audio nodes to automatically incorporate the 
username and the creation date. To make this work, we would set the Default node 
title format (as shown in the Audio settings screenshot) to Created by [author-name] 
on [yyyy]-[mon]-[date]. 

In most cases (and in all of the cases described in this book) tokens run invisibly in 
the background without requiring any adjustments by the end user. 

The Metadata Tags Tab 

The options in this section will be useful if you are setting up podcasts as part of a 
music or radio station, but will be less useful in other environments. By reducing 
the number of required options, you can simplify the form for uploading podcasts. 
The settings pictured in the following screenshot are all you need to get started 
publishing audio on the web. 
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The Players Tab 

The Audio module comes with several different players that can be used to play 
your audio files. You can use the settings on this page to choose your preferred 
player. As you can see in the following figure, you can specify a different player for 
each type of audio file. The "best" player will largely be determined by your aesthetic 
preference; all of the players do a great job playing audio stored on your site. 
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After you have chosen a player, click the Save configuration button to save 
your preference. 

Assign Rights to the Audio Module 

Now that we have installed, enabled, and configured the audio module, we need 
to assign rights to it. Click the Administer | User management | Roles link, or 
navigate to a d mi n/ user / rol e s. 

The possible rights that can be assigned are shown in the following figure: 



We will need to assign rights for the teacher role, the student role, the authenticated 
user role, and possibly the anonymous user role. 

For the authenticated user role, assign rights to download audio and play audio. 

For the student role, assign rights to create audio and edit own audio. 

For the teacher role, assign rights to create audio, edit own audio, and view 
download stats. 
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For the anonymous user role, assign the rights you think are appropriate. In most 
cases, if you are allowing anonymous users to see content, allowing them the rights 

to download audio and play audio is appropriate. 

Each time you assign rights to an individual roles, click the Save permissions button 
to save the rights for the role. 

Adjust Existing Views 

Currently, three views are being used to display student and teacher-created content. 
We will need to edit these views so that they return any audio nodes created 
within the site. 

To edit these views, click the Administer | Site building | Views link, or navigate 
to ad mi n / b u i I d/ vi ews. 

We need to edit three views: the teacher_blog view created in Chapter 4, and the 
studentjblog and conversation views created in Chapter 6. 

As shown in the following screenshot, these views can be edited by using the Edit 
link on the main Views administration page. 



Editing the student_blog View 

Click the Edit link as shown in the preceding screenshot. Then, in the Defaults 
display, under Filters, click on the Node: Type link, as shown by Item 1 in the 
following screenshot: 
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As shown by Item 2 in the preceding screenshot, add Audio to the node types 
returned in this view. Click the Update button to store this change, and then click the 
Save button (not pictured in the preceding screenshot) to save the view. 


Editing the teacher_blog View 

To edit the teacherjblog view, repeat the same steps for the studentjblog view. 



To get a clear overview of the differences between the student_blog and 
the teacher_blog view, see Chapter 6 for a description of how we created 
the student_blog view by cloning the teacher_blog view. 


] 
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Editing the conversations View 

Click the Edit link for the conversations view. Then, in the Defaults display, 
under Arguments, click on the Search: Links to link, as shown by Item 1 in the 
following figure: 


Home > Administer > Site building > Views 

Edit view "conversations" List Add 

View conversations, displaying items of type Node. 


Import Tools 


Export Clone 


I Page ivjl 



6 Defaults Default settings for this 

view. 




View settings 

© Relationships 

+\n\ 

© Sort criteria 

+im 

Tag: None 

None defined 


None defined 



Basic settings 

© Arguments 

+]tij 

© Filters 

+im 

Name: Defaults 

Search: Links to 


Node: Published True 


Title: None 





Style: List 

© Fields 

+mi 



Row style: Fields 

Node: Title 




Use AJAX: No 

Node: Post date Post date 




Use pager: Yes 

Node: Type Type 




Items per page: 30 

User: Name Name 





Distinct: No 
Access: Unrestricted 
Header: None 
Footer: None 
Empty text: None 
Theme: Information 


Defaults: Configure Argument "Search: Links to" 
Title: 

| Pages that link to % 1 

The title to use when this argument is present; it will ov 
percent substitution here to replace with argument titles 

Action to take if argument is not present: 

O Display all values 
© Hide view / Page not found (404) 

O Display empty text 
O Summary, sorted ascending 
O Summary, sorted descending 
O Provide default argument 
Validator options 


srride the title of the view and titles from previous arguments. You ci 
Use “%1“ for the first argument, "%2" for the second, etc. 


If this value is received as an argument, the argument will be 
ignored: i.e, "all values" 

Wildcard title: 


The title to use for the wildcard in substitutions elsewhere. 


| Node 


3 


Types: 

2 0 Audio 
D Assignment 
0 Blog post 

□ Book page 
0 Bookmark 

□ Page 

□ Story 

If you wish to validate for specific node types, check them; if n 

0 Validate user has access to the node 


are checked, all nodes will pass. 


Argument type: 


[Node ID 


3 


Action to take if argument does not validate: 

| Hide view / Page not found (404) v.| 

□ Allow multiple terms per argument. 

If selected, users can enter multiple arguments in the form of 1+2+3 or 1,2,3. 

□ Exclude the argument 

If selected, the numbers entered in the argument will be excluded rather than limiting the view. 


[ Update 1 [ Cancel 1 [ Remove | 
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As shown by Item 2 in the preceding screenshot, add Audio to the list of node types 
where this view will be validated. 

Click the Update button to store this change, and then click the Save button to save 

As we add additional content types into the site, we will need to update 
these views to account for the newly-added content types. 

Uploading an Audio File 

The instruction for uploading an audio file is shown in the following screenshot: 


the view. 



Home 

Create Audio 

Title: ♦ _ j _ 

|The First Podcast | 

The title can use the file's metadata. You can use the tokens listed below to insert information into the title. Note: the node 
title is escaped so it is safe to use the -raw tokens. 

O Token list 


Body: 

I m Source f & @ @ m 

^ | Format [Normal [ T ~|f B I U | * z x* § f— | tp =F ^ ^ -H- Break 

This is the finest podcast to ever be released upon an unsuspecting internet. 2 


Switch to plain text editor 

° Web page addresses and e-mail addresses turn into links automatically. 

° Allowed HTML tags: <a> <b> <blockquote> <br> <caption> <center> <code> <col> <colgroup> <dd> <del> 
<div> <dl> <dt> <em> <font> <hl> <h2> <h3> <h4> <h5> <h6> <hr> <i> <img> <li> <ol> <p> <span> 
<strong> <sub> <sup> <table> <tbody> <td> <tfoot> <th> <thead> <tr> <u> <ul> <tr > 

° Lines and paragraphs break automatically. 

More information about formatting options 
Audio File Info 

Current File: 

No file is attached. 

Add a new audio file: 3 

|C:\Documents and Settings\billfitzgerald\My Documents\Mj|[ Browse... ] 

Click "Browse..." to select an audio file to upload. Only files with the following extensions are allowed: mp3, wav, ogg. 
NOTE: the current PHP configuration limits uploads to 8 MB. 

0 Allow file downloads. 

If checked, a link will be displayed allowing visitors to download this audio file on to their own computer. 

WARNING: even if you leave this unchecked, clever users will be able to find a way to download the file. This just 
makes them work a little harder to find the link. 


4 _ 

[ Save ] [ Preview ] 
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To create a new audio file, click on the Create Content | Audio link, or navigate to 
node/add/audi o. 

1. Give the post a title 

2. Enter a description 

3. Click the Browse button to select the audio file to upload 

4. Click the Save button. 

Once you have submitted your podcast, you will be able to play it back as shown in 
the following screenshot: 

The First Podcast Edit 

Wed, 02/13/2008 - 01:25 - hank 

O ^ 00:00:17 ■ " 

° Length: 3:12 minutes (3.67 MB) 

Cl Format: Stereo 44kHz 160Kbps (CBR) 

This is the finest podcast to be unleashed upon an unsuspecting internet! 

Add new comment Download audio file 0 downloads 1 plays 


Using Podcasts in the Class 

Podcasts can be used in a variety of ways to support learning in the classroom. Some 
of these uses require extensive planning, but there are a range of ways that podcasts 
allow both students and teachers to share material quickly and easily. 

Creating Podcasts—Notes on Hardware and 
Software 

Many podcast tutorials focus a large amount of attention on specialized hardware 
and software required for podcasting. If you are looking to create complex podcasts 
involving live music, complex transitions between scenes, or professional-quality 
production, then you will probably need to invest in specialized equipment to help 
create your podcast. However, most podcasts require very little specialized software 
and hardware. 

Software 

Audacity (http: / /audaci ty. sourceforge. net/) can be downloaded for free, and 
works on Mac, PC, or Linux-based computers. Mac users can also create mp3 files 
with Garageband. Either of these programs will allow the editing of audio files, and 
the export of theses files as a podcast. 

-[ 182 ]- 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 








Chapter 8 


Hardware 

Podcasters can use handheld audio recorders to capture sound during interviews. 
Additionally, handheld or lavalier microphones (a microphone that attaches to 
a person's clothing, also called a lav or a lapel microphone) can be purchased to 
improve the sound quality when making original recordings. 

However, great podcasts require great content, and the best technical tools will not 
help overcome weak content. In this way, podcasts are directly comparable to other 
classroom activities: a good product requires thought, planning, and a clear sense 
of what the podcast is designed to achieve. Special audio effects and other bells and 
whistles are best left to the final part of the process, if at all. 

In short, you can create great podcasts with a handheld recorder and a single 
computer. Focus on your content first. 

Everyday Uses of Podcasts 

At the most simple level, teachers can use podcasts to create a body of resources 
for students; in a foreign language course, for example, a teacher can publish a 
podcast with a dialog that emphasizes vocabulary, or that gives pronunciations 
for verb conjugations. In an English or history course, a teacher can publish 
speeches or literary readings. These primary source materials can be used to 
augment the curriculum. 

For people looking to create a library of primary source materials, YouTube and 
Google Video can provide an amazing array of resources. Using a free online service 
such as h 11 p: / / v i xy, net, you can extract the audio from videos hosted on YouTube 
and Google video. Of course, you will need to make sure that you are not infringing 
on any licensing restrictions when you republish the content, but the amount of 
content available for reuse within these sites can be overwhelming. Extracting the 
audio also helps avoid any issues with content from these sites being eliminated by 
firewalls or content filters. 

The Internet Archive, at h 11 p : / / www. archi ve. org/detai I s/audi o, also offers a 
rich variety of freely-available primary source material. 

Additionally, students can create podcasts as a form of audio blog—this can be an 
especially powerful tool for students who are visually impaired, or for students with 
learning differences who have difficulty expressing themselves in writing. 
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Podcasts as a Tool in Project-Based Learning 

Podcasts can also be used as part of a project-based lesson. In this context, creating 
a good podcast requires a blend of skills used in virtually all academic work, as 
outlined below. 

1. Initial research leading to an outline/storyboard. This initial storyboard can 
be rough, but it should give a clear idea of the point/goals of the podcast. 

2. Additional research/ editing. At this stage, the point that was laid 
out in the original storyboard should be examined. Is it logical? Is it 
entertaining/ interesting enough to be the subject of a podcast? Are there any 
counterarguments that need to be addressed? 

3. Finalize the storyboard. 

4. Draft a script. 

5. Practice, and revise the script. 

6. Record the podcast. 

7. If necessary, add sound effects. 

8. Save the recording as an mp3 (usually by using Audacity or Garageband, as 
described earlier in this chapter). 

9. Upload the podcast to your site as an audio file. 

As students progress through the various steps of creating a podcast, they can use 
the tools within the site to support their work. Initial research can make use of 
bookmarks; various drafts of the storyboard and script can be published as blog 
posts, and students can provide feedback via comments. 

Additionally, students can use their blog (or quick podcasts) as a reflective tool to 
assess the effectiveness of their creative process. 

Ideas for Podcasting Projects 

Using the general structure described above, you can work with students on a 
variety of projects. 

Some General Examples 

• In a literature class, you could have your students work in a group to distill 
scenes from a novel into a series of radio plays. 

• In a history course, you could have students do news stories as 
embedded reporters. 
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• In an Art history course, you could use the body of the audio post to display 
a series of paintings, and use the podcast to discuss them. 

• For a physics course, students could prepare a series of podcasts on sound, 
ranging from the physics of musical instruments to everyday phenomena 
such as the Doppler Effect. 

The podcast is a flexible medium capable of storing many different varieties of 
work by students. For this reason, novice podcasters will benefit from a clear 
structure that supports them as they develop their podcast. Podcasts are a useful 
tool because, if you believe the anecdotal stories concerning podcasts and student 
motivation, students tend to care more about a podcast than they do about a paper 
or a poster. Given that creating a podcast requires comparable research and analysis 
skills as summary projects delivered in other mediums, podcasts can provide a less 
traditional mechanism for reinforcing some more traditional learning goals. 


iTunes or Not 

iTunes and iPods are frequently connected to the topic of podcasting. While the 
iTunes store is a useful place to find podcasts, and can help increase the visibility of 
your podcast, you do not need to use iTunes as part of your podcasting regimen. In 
general, if the purpose of your podcast is to reach an audience outside of your school 
community, and/or you are creating a series of podcasts over time, then iTunes 
could be a good way to extend the reach of your podcast. 

In situations where the podcasts are informal in nature, or where podcasts are more 
of a regular means of communication, iTunes is an additional step that adds little of 
value to the teaching and learning involved in creating podcasts. 

If you want to add your podcast to the iTunes store, Apple has laid out the process 
on their website. Navigate to http://www.apple.com/itunes/whatson/podcasts/ 
creatorfaq, html , and follow the link provided in the section titled How do I 

submit my podcast? 

Images and Image Galleries 

When it comes to storing images, Drupal provides many different options. In this 
book, we will focus on the Image module — available athttp: / /drupal . o r g / 
project/image —but before we get into the details, we will quickly examine some 
of the other options that exist. Our choice of the Image module has less to do with 
any real problems with the other options, and more with the relative simplicity of the 
Image module. 
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One very popular method of storing images uses the following four modules: 

• Imagefield: http://drupal.0rg/pr0ject/i magefield 

• Image API: http: / /drupal . org/proj ect/i mageapi / 

• Imagecache: http: / /drupal . org/proj ect/i magecache 

• Thickbox or Lightbox 2 :http://drupal . org/proj ect/thi ckbox or 
http://drupal .org/project/l i g h t b 0 x 2 

In very brief terms, the Imagefield module creates a CCK field that holds images. 
Imagecache (using the functionality supported by the ImageAPI) scales the images 
to create thumbnails. Then, either Thickbox or Lightbox 2 can be used to create pop 
up windows to display galleries. This method of sharing images also integrates with 
the Views module. 

Using Imagefield, Imagecache, and the Image API provides an incredible amount of 
flexibility. However, for many needs, this is overkill. The Image module provides a 
relatively straightforward solution. 

Sharing Images with the Image Module 

To get started, download the Image module from http://drupal.org/project/ 
i ma g e . Then, upload and the module as described in Chapter 3. 

Once the module is uploaded into your sites/all/modules directory, navigate 
to Administer | Site building | Modules, or ad mi n build modules. Enable the 
Image and the Image gallery modules. 

Click the Save configuration button to submit the form and save the updates. 

Configuring the Image Module 

Like the Audio module covered in the first half of this chapter, the Image module, 
when enabled, creates its own content type. As we configure the module, we will 
complete the following steps: 

1. Adjust the default settings 

2. Set image-specific settings 

3. Assign a taxonomy for images; this includes setting up galleries. 

4. Assign permissions to create and edit images. 

5. Adjust the Student blog, the Teacher blog, and the conversations view. 
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Step 1: Adjusting the Default Settings 

As with all content types, the default settings can be edited at Administer | Content 
management | Content types, or ad mi n/content/types. 

Click the edit link for the Image content type. The only settings we need to change 
are in the Workflow settings section; we want to set Images to be Published, and we 
want Attachments to be Disabled. 

Click the Save content type button to save the changes. 

Step 2: Adjusting the Image Module Settings 

To adjust the base settings of the Image module, navigate to Administer | Site 
configuration | Images, or a d mi n / s e 11 i n g s / i ma g e . As seen in the following 
screenshot, we have two options: Files and sizes and Image gallery. 
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We will start by configuring the Files and sizes options. 

Item 1 indicates the path inside the files directory; unless you have a custom storage 
structure for images, leave this setting untouched. 

Item 2 indicates the maximum image size. Leaving this set to a larger value will, over 
time, use more storage space on your server. However, leaving this at a larger file 
size will also make the site easier to use, as people won't need to know how to resize 
images prior to upload. The "best" solution will be a balance between your storage 
needs and the technical expertise of your users. 

Item 3 allows you to scale, or scale and crop images. You can use these defaults, 
and/or set additional size options. 

Click the Save configuration button to save these options and move on to the Image 
gallery settings. 

Image Gallery 

The settings on the Image gallery administrative screen allow you to set some basic 
options for how galleries are displayed. 



These settings are largely a matter of personal preference. The first option. Images 
per page, will need to be balanced against the width of the page to ensure that all 
images will display cleanly. Generally, most settings between 4 and 6 images will fit 
with no issues. 
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After you have adjusted these settings, click the Save configuration button to save 
the changes. 


Step 3: Using the Keyword Taxonomy and Creating 
Galleries 

As we did with our other content types, we use the Keywords taxonomy to 
organize posts. As initially described in Chapter 3, navigate to Administer | Content 
management | Taxonomy, or ad mi n/content/taxonomy. Click the edit vocabulary 
link for the Keywords vocabulary, and add Image into the list of Content types. 

Click the Save button to save the change. 

Galleries 

To create and manage galleries, navigate to Administer | Content management | 
Image galleries, or a d mi n / c o n t e n t / i ma g e. 
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As shown in the preceding screenshot, creating galleries involves giving them a 
Name, and, optionally, a Description, a Parent, and a Weight. 

By creating Parent galleries, you can nest galleries inside one another. For example, 
you can set up one gallery for 2009, and then individual galleries within 2009 for 
each month. 

The Weight setting is used to order galleries, with lower numbers appearing first. 
Click the Submit button to create your gallery. 

Step 4: Assign Permissions 

To assign rights to the Image module and the Image gallery module, navigate to 
Administer | User management | Permissions, or admi n/user/permi ssi ons. 
Scroll down to the section for the Image module. 


Permission 

anonymous 

user 

authenticated 

user 

site 

admin 

student 

teacher 


image module 

create images 

□ 

□ 

0 

0 

0 

edit images 

□ 

□ 

0 

□ 

□ 

edit own images 

□ 

□ 

0 

0 

0 

view original images 

□ 

0 

0 

□ 

□ 

image_gallery module 

administer images 

□ 

□ 

0 

□ 

0 


For the image module: 

• Assign student role the rights to create images and edit own images. 

• Assign the teacher role the rights to create images and edit own images. 

• Assign the authenticated user role the rights to view original images. 

• Assign the site admin role full rights. 
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For the image_gallery module: 

• Assign both the teacher and the site admin role rights to administer images. 

This will give users in both roles the rights to create new galleries, and manage 
existing galleries. In a site with many teachers, this right should probably not be 
given to all teachers, but should be limited to users with the technical expertise to 
manage it efficiently. 

Click the Save permissions button to save the changes. 


Step 5: Adjusting Views 

As was covered earlier in this chapter, we need to adjust the views for the Teacher 
blog, the Student blog, and the conversations view to ensure that images get 
included in these different views. 

The steps used to add Audio nodes to these views—covered earlier in this chapter — 
can be replicated to add Image nodes. 

Creating Images 

Now that the image module has been enabled and configured, we need to upload a 
photo onto the site. 

To add an image, navigate to Create content | Image, or node / add / i mage. 
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As shown in the preceding screenshot, give the image a Title, add it into an Image 
Gallery, categorize it using a Keyword, and then Browse and select the image. Add 
some descriptive text in the Body (which will make the image easier to find via 
searches) and then click the Save button to upload the image. 
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Summary 

Depending on the educational goals, podcasts can range from spontaneous acts of 
creation, such as an audio blog, to a crafted production like a radio play. Creating 
podcasts uses a range of academic skills that can be addressed explicitly in the 
process of creating the podcast. The flexibility of the podcast as a medium for 
expression can be leveraged in support of many different learning goals. However, 
the most important element of podcasting involves removing barriers between 
learners and publishing content. At the most basic level, a podcast is just an mp3 
file you upload to your site. By remaining focused on the content within a 
podcast—as opposed to the bells and whistles of unnecessarily complex production 
of podcasts—you ensure that podcasts remain an accessible tool for daily learning 
and extended projects. 

While the goals and uses of sharing images will vary from class to class, the ability 
for students to share images creates an additional means by which students can 
contribute. The technique covered in this chapter provides a flexible, adaptable tool 
that can be used to organize images for a variety of different educational needs. 
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Video 


Using video in the classroom can be as simple or as complex as you want to make it. 
As with any use of technology in the classroom, effective planning will help ensure 
that the technology supports a specific educational goal. 

When using video as part of a student project, you can organize the project into these 
general areas: 

• Clarify the concept: Frequently, the assignment will provide the context 
within which the student will work. If the assignment is open-ended, the 
students should be able to articulate the goal of their video, and a specific 
outline of the action, before they begin the next step. 

• Assemble the media: The media will support, demonstrate, or explain the 
concept developed in the first step. The media can be a new video that is 
recorded using screen capture or a video camera, or existing freely-available 
media from a variety of online sources. 

• Edit/organize the media: Cut unnecessary scenes, add transitions, and clean 
up the audio. In many cases, this step is not essential, as not every project 
requires flawless production values. 

• Save the video in a web-friendly format. 

• Upload the video to the Web. 

The purpose of this chapter is not to document the skills to make you an 
award-winning film maker. However, after reading this chapter, you will have a 
solid overview of how to create and share videos. As with podcasts, the content of 
your video is the most important thing. If you have compelling content, you have 
made the most important step toward creating compelling video. 
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Setting up the Video Content Type 

In this chapter, we will cover how to share video using CCK and the Embedded 
Media Field module, available at http: / /drupal . o r g / proj ect/emfi el d. There are 
other methods available for processing, storing, and sharing video that we will cover 
later in the chapter. For general use, however, we recommend the use of Embedded 
Media Field, as it balances ease of use and flexibility. 

Install the Embedded Media Field Module 

Download the Embedded Media Field module from http://drupal.org/project/ 
e mf i e I d . Upload this module into your si tes/al I /modul es directory, as described 
in Chapter 3. 

Click on the Administer | Site building | Modules link, or navigate to 

ad mi n/bui I d/modul es. Enable the Embedded Media Field and Embedded Video 

Field modules, as shown in the following screenshot: 


□ 

Embedded 

6.X-1.0- 

Audio Field 

alpha3 

□ 

Embedded 

6.X-1.0- 

Image Field 

alpha3 


Embedded 

6.X-1.0- 


Media Field 

alpha3 

□ 

Embedded 

Media 

Import 

6.X-1.0- 

alpha3 

□ 

Embedded 

Media 

Thumbnail 

6.X-1.0- 

alpha3 

Xl 

Embedded 

6.X-1.0- 


Video Field 

alpha3 

0 

Fieldgroup 

6.x-2.0-rc7 


Defines a field type for displaying third party music, podcasts, and other audio, such as podOmatic and 
Odeo. 

Depends on: Embedded Media Field (disabled). Content (enabled) 

Defines a field type for displaying images from third party providers, such as Flickr or Photobucket. 

Depends on: Embedded Media Field (disabled). Content (enabled) 

Provides an engine for modules to integrate various 3rd party content providers, such as Video 
Neighborhood, Image Neighborhood, and Audio Neighborhood. 

Depends on: Content (enabled) 

Required by: Embedded Audio Field (disabled). Embedded Image Field (disabled). Embedded Media Import 
(disabled). Embedded Media Thumbnail (disabled). Embedded Video Field (disabled) 

Please use FeedAPI and the Feed API Element Mapper instead of emimport, which has been deprecated 
for Drupal 6. 

Depends on: Embedded Media Field (disabled). Content (enabled) 


Allows custom thumbnails for Embedded Media Fields (Not ready for Drupal 6 yet). 
Depends on: Embedded Media Field (disabled). Content (enabled) 


Defines a field type for displaying third party videos, such as YouTube and Google Video. 

Depends on: Embedded Media Field (disabled). Content (enabled) 

Create field groups for CCK fields. 

Depends on: Content (enabled) 


Click the Save configuration button at the bottom of the page, to save your changes. 
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Configure Embedded Media Field 

Configuring the Embedded Media Field module involves two steps: setting up 
the use of an optional library, and making any necessary adjustments to the 
supported providers. 

Click on the Administer | Content Management | Embedded Media Field 
Configuration link, or navigate to ad mi n/content/emfi el d.As shown in the 
following screenshot, there are sections to this form: General Settings and 
Embedded Video Field. 


Home 

Embedded Media Field configuration 

O General Settings 
O Embedded Video Field 

[ Save configuration - ] [ Reset to defaults ~] 


Configuring the General Settings 

Open the General Settings fieldset. The only option within this section is whether 
or not to use the SWF Object JavaScript library. Your site will run perfectly well 
without it, but using it has some technical benefits. In order to use the SWFObject 
library, install the SWFObject API module, available at http://drupal.org/ 
proj ect/swfobj ectapi . However, using this library is not essential to use the 
Embedded Media Field module. 

Configuring the Embedded Media Field Settings 

The Embedded Media Field settings provide some base options for the different 
video providers supported by the module. 
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Open the Embedded Media Field configuration fieldset to see the list of 
supported Providers, as shown in the following screenshot:. 

Embedded Media Field configuration 

Embedded Video Field 

The following settings configure content with any fields controlled by Embedded Video Field. 
v Providers 

The following settings determine what providers are allowed, and what provider-specific 
options, if any, are set. 

P Blip.tv configuration 
t> Brightcove configuration 
C> Google configuration 
C> iFilm configuration 
[> JumpCut configuration 
[> Live Video configuration 
o> MetaCafe configuration 
o MySpace configuration 
t> Rewer configuration 
O Sevenload configuration 
l> YouTube configuration 
O Custom URL configuration 



The providers listed here can be enabled or disabled, as shown in the 
following screenshot. However, even if you allow a specific provider 
via this screen, you still have the opportunity to deny specific providers 
when you are adding the embedded media field to a content type, as 
described in the section Setting up the Video Content Type. Also, additional 
providers can be added with a little custom development. To see how 
to support additional providers, look at the youtube, i nc file found in 
the Embedded Media Field module, atemfi el d \ c 0 n t r i b\emvi deo\ 
pr ovi der s. 
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To support video from providers not listed as default options, you can use the 
features in Custom URL configuration. To access these settings, scroll down to the 
Custom URL configuration section. You want to Allow content from Custom URL, 
and allow all media types, as shown in the following screenshot: 


v Custom URL configuration 

These settings specifically affect videos displayed from custom URLs. When a field uses a URL it 
determines to be a link directly to a video file, it will embed that file into the content. 

0 Allow content from Custom URL 

If checked, then content types may be created that allow content to be provided by Custom URL. 

Supported Types: 

0 Windows Media (wmv) 

0 Windows Media (wma) 

0 Flash (swf) 

0 Flash Video (flv) 

0 Quicktime (mov) 

0 Quicktime (mp4) 

0 Real Media (rm) 

Select the video types you wish to support. When a custom url with that type is entered into an embedded 
video field, it will be parsed and displayed appropriately. If a type is not supported, then it will be ignored. 


To save these settings, click on the Save configuration button.. 
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Creating the Video Content Type 

When creating the video content type, we will refer to the process outlined in 
Chapter 3. When creating a content type you will need to: 

1. Create the content type. 

2. Add fields to the content type. In this case, we will add the field that will 
contain the embedded video. 

3. Assign a taxonomy to the content type: In this case, we will allow the video 
content type to be organized or described using the Keyword taxonomy. 

4. Assign permissions to the content type: In our example, both the student 
and teacher role will be assigned permissions over videos. 


Step 1: Create the Content Type 

Click on the Administer | Content management | Content types link, or navigate 
to ad mi n/content/types. 


Click the Add content type tab. 


In the Identification section, use the following values: 


• Name: Video 


• Type: video 

• Description: Embed video in your site. 




In the Submission form settings section, the Explanation or submission 
guidelines can be set to: 


<p >1 f you 

are embeddi ng 

vi deo 

from an 

ext er 

n a 1 sit 

e (like 

Goog1 e Vic 

ieo or 

B1 i p . t v) 

add 

the URL 

of the 

vi deo 

into the 

<em>Vi deo 

1 ocati 

on </ em> 

field 

. </ p> 




<p >1 f you 

are up 

loading 

vi deo 

to this 

site, 

upl oad 

the video 

as an at t e 

i c h me n t 

, and t1 

len pa 

s t e the 

u r 1 of 

the f i 

1 e into the 

<em>Vi deo 

1 ocati 

on </ em> 

field 

. </ p> 





• In the Workflow settings, set the default to Published. 

• In the Comment settings section, set the default to Read/Write, and 
configure the comment displays as described in Chapter 3. 


Click the Save content type button to create the content type. 
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Step 2: Add the Video Field 

After you save the Video field as described above, you will be redirected to the 
Content Types administration page at Administer | Content management | 
Content types, or ad mi n/content/types. Click the add field link for the video 
content type. 

In the add field administrative screen, enter the following values: 

• Field name: video_location 

• Label: Video location 

• Field type: Embedded video 

• Form element: 3rd Party Video 

Click the Save button to move to the configuration screen for this field. 

Configuring the Field 

The field settings are broken into two sections: the settings for this specific field, the 
Video settings; and the General settings. 

The Video settings contain four separate sections: 

• Providers supported: These options let you specify what video services will 
be supported for this field. This list is generated from the list of providers 
approved earlier in this chapter, when you configured the Embedded 
Media Field. 

• Video display settings: This option lets you specify the size that videos will 
be displayed at when users are viewing the individual post. 

• Video preview settings: This option can be used to specify the size that the 
video will be displayed at during content previews. 

• Thumbnail: This option can be used to specify a display size for thumbnails. 



The various display settings can generally be left at their default settings. 
One aspect to consider, however, is that these settings integrate with the 
Views module; this allows you to create one size for the display settings, 
and a separate, different size for either the thumbnails or the video 
display settings. You can the use a view to display a collection of videos 
at the specified dimensions. 
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The Video settings also allow you to specify Help text—to help guide users as they 
upload videos. For the help text, you can use: For some video providers, you will 
be able to simply enter the URL where you see the video. For other providers, you 
will need to use the embed code. If one method doesn't work, please try the other. 

Configuring the Global Settings 

In the Global settings, set the field to Required, and the Number of values to 1. 
Then, click the Save field settings button to save your settings. 

Ordering the Fields 

After you save the field settings, you will be returned to the Manage Fields admin 
screen for the Video content type. 

Drag the fields into the order in which you want them to be displayed, and then click 
the Save button to save your changes. 

Step 3: Assign a Taxonomy 

Click on the Administer | Content management | Taxonomy link, or navigate to 
ad mi n/content/taxonomy. 

As described in Chapter 3, edit the Keywords vocabulary and add Video to the list of 
content types categorized. 

Step 4: Assign Permissions 

Click on the Administer | User management | Roles link, or navigate to 
admin/user/roles. Click the edit permissions links for the teacher role and the 
student role; open the permissions tabs for each role in a separate tab to streamline 
the process of assigning permissions. 

As described in Chapter 3, assign the teacher role and the student role permissions to 

create video content, delete own video content, and edit own video content. 

Click the Save permissions button to save the permissions assigned to both roles. 
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Embedding Videos 

Now that we have created the Video content type, it's time to start sharing some 
video. Log in using one of the test accounts created earlier. As both the student and 
teacher role have rights to add video, a test account in either the student or teacher 
role will suffice. 

Embedding from an External Site 

Click on the Create Content | Video link, or navigate to node/add/video. 

Complete the form as shown in the following screenshot, by filling in the appropriate 
values for Title, Keywords, Video location, and Body. 
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The value you enter in the Video location field will vary on a site by site 
basis due to differences in how sites store and share video. In most cases, 
you will be able to enter the URL of the page where the video plays, but 
in some cases, such as for the Internet Archives, you will need to enter 
the specific path to the video file. For other sites, you may need to use the 
provided embed code. 

Click the Submit button, and you will see your video, as shown in the 
following screenshot: 
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Embedding from the Local Site 

Click on the Create Content | Video link, or navigate to node/add/video. 

Complete the form as described above, by filling in the appropriate values for Title, 
Keywords, and Body. For now, leave the Video location blank. 

Scroll down to the File attachments section. Click the Browse button and navigate to 
the required video file. 

Click the Open button as shown in the following screenshot: 



Click the Attach button. You will see the progress meter, as shown in the 
following screenshot: 
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When the file has finished uploading, highlight the location of the file as shown in 
the following screenshot: 


v File attachments 

Changes made to the attachments are not permanent until you save this post. The first "listed" file will be 
included in RSS feeds. 


Delete List Description 

□ 0 


DIA02.flv 


http://ivmv.alphabetademo.com/packt/files/DIA02.flv 


Size 


864.31 KB 


Attach new file: 


Browse... 


The maximum upload size is 1 MB. Only files with the following extensions may be uploaded: jpg jpeg gif png txt 
doc xls pdf ppt pps odt ods odp. 


Attach 


Copy the file location (highlighted in the preceding screenshot), and paste it into the 
Video location field as shown in the following screenshot: 



Click the Submit button to save your video. 
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Sharing video that has been uploaded to your site can require a significant amount of 
server resources. If a small number of videos are shared in this way, it will not have 
a significant impact. If, however, video sharing becomes a widespread need, you 
should look to storing your videos on an external service and streaming them from 
there, or setting up your site to process and compress videos as mentioned later in 
this chapter. 

Additionally, sharing video by uploading it to the site can run into file size upload 
limits. To adjust these limits, navigate to Administer | Site configuration | File 

uploads, oradmi n/setti ngs/upl oads. 

Adjusting the Student and Teacher Blogs 

Now that we have added the Video content type to the site, we need to adjust the 
student and teacher blogs to display video posts. Editing the view that generates the 
Teacher blog is covered in Chapter 4; editing the view that creates the Student blog is 
covered in Chapter 6. 

Additionally, the conversations view, created in Chapter 6, will also need to 
be updated. 

The necessary steps for updating all three of these views are covered in Chapter 8. 


Hardware and Software to Create Videos 

The complexity of producing videos can vary widely. As an easy option, videos can 
be shot by one person in natural light using a cell phone and uploaded directly to the 
Web; a complex option would be a video shoot requiring a large crew, specialized 
cameras, microphones, lighting equipment, video editing software, and dedicated 
computers for video editing and rendering. The variables for more complex setups 
are beyond the scope of this book, and fortunately, largely unnecessary for most 
video production. 

In short, if you are starting a video program, or just getting into video, you don't 
need to spend thousands of dollars on specialized equipment and software. As 
a general rule, specialized equipment adds complexity. As with most classroom 
uses of technology, you want to make sure that you are emphasizing the learning 
supported by the technology, as opposed to the technology itself. To that end, a 
simpler production environment can help support your video program by making it 
easier and faster to publish videos. 
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Hardware 

Before spending any money on hardware or software for producing videos, talk to 
people within your organization. If your school offers a course in video production, 
speak with the instructors and students of that course. In addition to getting good 
recommendations on equipment, you also might be able to enlist support and 
assistance if you need it. 

Cameras and Video Capturing Equipment 

Video cameras range from simple, inexpensive web cams to complex, expensive, 
professional-quality digital video cameras. Additionally, many computers now 
come with built-in webcams. If you are unsure about the quality of the camera you 
need, talk to any people doing video work within your school, spend some time 
researching online, and then go down to a local store and try out some cameras 
before you buy. Depending on the needs of your project, there are many inexpensive 
options when it comes to capturing video, ranging from the video cameras on many 
cell phones to flip video cameras. 

Microphones and Audio Quality 

Some mid-level to higher-end video cameras have a jack where you can record 
audio directly from a microphone. In some cases, you might also want to use an 
external microphone (as described in Chapter 8) to capture your audio tracks, or to 
capture ambient noise to use during transitions. Capturing a separate audio track 
will require more work during the production and editing of your video, but it will 
generate better sound quality. However, it adds a level of complexity that will not be 
necessary for many video projects. 

Lighting Equipment and Editing Stations 

For many classroom uses, specialized lighting equipment and editing stations, while 
nice, are not necessary. Obviously, if the videos are being produced as part of a 
course on video production, part of the curriculum will likely include the effective 
use of lighting. 

Editing stations can be useful when creating and editing longer videos, as a 
computer specifically configured for processing video will be faster and more 
efficient, and will therefore save time. However, for many classroom uses, a 
specialized editing station is not necessary, and adds a level of technical complexity 
that can slow down students. 
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If your video project requires interviews, then a tripod can be invaluable for 
recording these interviews. Low-end tripods can be purchased for around US $20.00, 
with higher-end tripods costing US $100.00, and above. 

Copying Videos from YouTube/Google Video 

When uploading and playing videos on your website, you should pay attention 
to file size. Most video software packages will compress video, but there are times 
when you might not want to use a local computer to compress video, simply for 
reasons of time. In these cases, you can use Google Video or YouTube to compress 
the video. Once the video has been compressed, you can download it to your local 
machine, and unpublish/delete the video from Google Video or YouTube. 

Before you download video from a website, make sure that downloading 
the video does not violate the licensing terms for reusing the video. If you 
are ever unsure of the licensing terms for a video, check with the author 
or copyright holder of the video before using the video. 

The following websites will download videos from most video hosting sites onto 
your local hard drive: 

• http://keepvid.com/ 

• http:// www. techcrunch. com/get-youtube -mo vi e/ 

Additionally, you can download and install the Video Download Helper browser 
extension for Firefox from https://addons. mozi I I a. org/en-US/fi refox/ 
addon/3006. 

This browser extension allows you to download videos from most video sharing 
sites; as such, this can be useful if you want to show a video from a site that happens 
to be blocked by your organization's firewall. Download the video from a location 
outside the firewall, and upload it to your site as described earlier in this chapter. 
Then, you can display this video from within the firewall. 

Software to Create and Edit Videos 

As mentioned earlier, for some video projects, no real editing is required. If you need 
to edit video, however, you have a range of options, from free to fairly expensive. 
The following list provides some of these options. 
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Desktop Software 

• Windows Movie Maker: A video editing utility installed with 
Microsoft Windows 

• iMovie: A video editing utility installed on Macs 

• Quicktime Pro: A relatively inexpensive cross-platform video editing tool 

• Camtasia: A PC only tool, used for screencasts 

• CamStudio: A Free, cross-platform tool, used for screencasts 

• Wink: A free, cross-platform tool, used for screencasts 

• Adobe Premiere: A cross-platform tool. It is a part of Adobe's Creative Suite, 
and is fairly expensive, but is a powerful video editing tool 

• Final Cut Pro: A Mac only powerful video production tool, which is 
fairly expensive 


Online Tools 

Many online tools can be used to create videos, and many sites allow you to 
add clips, edit them down, add audio, and then compile the completed video. 
Additionally, some sites, such as Google Video and YouTube, allow video to be 
uploaded directly from mobile phones and other handheld devices. Alan Levine 
has compiled a list of over 50 options at http: / /cogdogroo. wi ki spaces, com / 

St or yTool s. 

In addition to these tools, the Jing project athttp://j i ngproj ect. com/ is an online 
tool that lets you collate media into a completed video. 

Also, although it isn't specifically an online tool, many mobile phones allow you to 
take videos and upload them directly to Google Video or other video sharing sites. 
Once your video is online, you can download it as described earlier in this chapter. 

Using Videos in the Classroom 

The subject matter will play a role in determining how to use video, and how much 
detail (if any) to pay to production values. 

Using video effectively requires good planning, and some specific ideas about the 
goals you would like to achieve. In addition to the actual video, students should 
be expected to learn from the process of making the video. During video-based 
projects, students should be blogging about their process and their progress, sharing 
bookmarks on their research, and even constructing short audio podcasts about 
the project. These points of reflection will provide a more complete picture of the 
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student's work over the course of the project, and will also help to reinforce one of 
the most important lessons of video production: people get better at something by 
thinking about how they want to achieve their goals, and the means that they are 
using to achieve them. 

Student Projects 

If we look at the video from a storytelling or a documentary perspective, we can 
structure projects within and across curricular boundaries. 

Some brief examples: 

• Language learning: Students can write and film plays that demonstrate 
vocabulary usage, the use of new grammar, the incorporation of dramatic 
elements, and so on. These plays can be used in acquiring a foreign language 
or in studying literature. 

• Videotape field trips: Prior to a field trip, form your class into several 
groups. Each group is responsible for producing a documentary of the trip. 
The specific goals of the documentary can be tailored to support specific 
educational goals. 

• Video bookends: Each student produces a video about themselves at the 
beginning and the end of the school year. This type of project can be used 
within a specific course as part of a portfolio, or across courses as part of a 
holistic assessment of student growth. 

• Videotape labs: By adding a video element to labs, students can document 
their steps and process more clearly. Additionally, in the process of planning 
and creating the video, students will generate a traditional lab report. Over 
time, videos can reveal a more clear and compelling portrait of student 
involvement in a course. 

None of these projects have complex production needs, and all can be produced 
using inexpensive equipment, and without specialized hardware or software. 

Teaching with Video 

This section does not address the use (or lack thereof) of feature films in education. 
Instead, this section addresses how to use primary source material found on the Web 
to support teaching and learning. Brief clips from video archives that illustrate a 
clearly-defined topic can be used to provide context, introduce a key idea, or provide 
a point of reference. 
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Given the range of video available on the Web, we have a wide range of 
opportunities open to us. 


A brief list of sources that contain public domain or Creative Commons licensed 
video includes: 


• ht t p 

• ht t p 

• ht t p 

• ht t p 

• ht t p 


//wi ki . creati vecommons.org/Content_Curators 
II co mmon s. wi ki medi a. org/wi ki / Category: Vi deo 
//our me dia.org/ 

II ope n-vi deo. o r g/ 

/ / www.archive.org/details /mo vies 


These video repositories all contain a wealth of freely-available content. However, 
many of these repositories also contain video that would be inappropriate for 
younger students. 

Teachers can create video to achieve specific educational goals. In one of the best 
examples of effective video use I have seen, a math instructor named Dan Meyer 
filmed a series of events that can be measured over time: distance, elevation, speed, 
and so on. Then, he showed these videos to his students, and made them graph what 
was shown in the videos. The full description, including the videos he created for his 
lesson, are available on his blog at h 11 p: / / b I og. mrmeyer. com/ ?p=213. 

Although creating new videos as part of a curriculum is time-consuming, it can also 
be a useful tool for modeling how to use video effectively for students. 


Drupal as a Video Hosting and 
Processing Platform 

Drupal can be configured to work as a fully-functional YouTube or Google Video 
clone, by using either the FlashVideo module (http://drupal.org/project/ 
fl ashvi deo) or the Media Mover module (http://drupal.org/project/ 
me d i a _ mo v e r ). Setting up the environment to serve video requires some familiarity 
with setting up Linux-based servers and an open source video conversion utility 
called f f mp e g . The advantage of building your own video processing site is that 
it gives you full control over all aspects of your material, with none of the privacy 
concerns, or concerns over inappropriate content, that you may have with YouTube 
or Google Video. 
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Additionally, if your academic program needs to support the streaming of large 
amounts of video, using either FlashVideo or Media Mover will have performance 
benefits. As noted above, using FlashVideo or Media Mover requires a more robust 
server environment, but the benefits of hosting your own video processing (that is, 
onsite conversion of different video formats to Flash files) can justify the additional 
time needed to set up the server infrastructure. 

Although the complete details of setting up such as server environment are beyond 
the scope of this book, you can read more details of how to set these systems up in 
the documentation for the Media Mover and the FlashVideo modules. 

Summary 

If you are interested in learning more about communicating with video, the Web 
is filled with incredible resources. Three sites that have particularly useful 
information include: 

http:// www. youtube, com/vi deo_t ool box 

http:// www. ourvideo.org/tool ki t/fiI es/content. htm 

http: / /current, com/make/trai ni ng 

However, the most important thing to remember about video is that it doesn't need 
to be technologically complex. If you keep the focus on what can be learned through 
making the video, in addition to the actual video, you can use the process of creating 
video to help your students learn more efficiently. 
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Forums and Blogs 


This chapter explores the relationship between blogs and forums. These tools 
support communication between site members, but each tool offers different 
capabilities, and using them effectively requires a clear understanding of how these 
tools relate to one another. Depending on the goals of your course, you can choose 
the tool that matches your instructional goals, and your students' learning styles. 

The first half of this chapter covers how to install and configure the Forum 
module. The second half gives a brief overview of the relationships between 
forums and blogs. 


Install the Forum Module 

Drupal comes with a core Forum module. To install this module, click on the 
Administer | Site building | Modules link, or navigate to ad mi n/bui I d/modul es. 
Select the checkbox next to Forum, and then click the Save configuration button at 
the bottom of the page to enable the module. 

Configure Forums 

After enabling the Forum module, we need to configure it. To begin this process, 
navigate to Administer and select the By module tab, or navigate directly to 
admi n/ by - modul e. 
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Click the link for Forums, which brings us to the Administer | Content 
management | Forums or a d mi n / c o n t e n t / f o r u m page. 

Containers and Forums 

When configuring forums, we can organize our forums using top-level containers 
and individual forums. 


Forums 


1 2 

Add container Add forum 


3 

Settings 


This page displays a list of existing forums and containers. Containers (optionally) hold forums, and forums hold forum 
topics (a forum topic is the initial post to a threaded discussion). To provide structure, both containers and forums may 
be placed inside other containers and forums. To rearrange forums and containers, grab a drag-and-drop handle 
under the Name column and drag the forum or container to a new location in the list. (Grab a handle by clicking and 
holding the mouse while hovering over a handle icon.) Remember that your changes will not be saved until you click 
the Save button at the bottom of the page. 


[more help...] 


Name Operations 

There are no existing containers or forums. Containers and forums may be added using the add container and add forum 
pages. 


To add a container, click the Add container link as shown in the preceding 
screenshot by Item 1. 

To add a forum, click the Add forum link as shown in the preceding screenshot 
by Item 2. 



Forums do not need to be in containers. If you have more than one forum, 
a container is a useful tool to organize your forums. However, in setting 
up forums, it is recommended that you start as simply as possible, as you 
can always create additional forums and containers as the need for them 
arises. In the early stages of building community, you want your site to 
look busy; multiple forums can fragment user interaction, which makes 
your site appear less busy. Multiple forums can also overwhelm users as 
they are attempting to learn how to navigate around your site. Too many 
options (in the form of multiple forums) can feel overwhelming. 
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For an example of containers, and forums within that container, navigate to 
http://drupal . org/forum. Here, Support is a container; Post installation. Before 
you start. Installing Drupal, and Upgrading Drupal are all forums inside the 
Support container. 





Documentation | Download Support I Forum Contribute Contact 


Forums 


• Post new forum topic. 




Forum 

Topics 

Posts 

Last post 

Support 

Try searching the forums using the advanced search option first or a specific project's bug reports. Remember all support 
on this site is on a volunteer basis, so please visit the forum tips for posting hints. 

Post installation 

Drupal is up and running but how do I...? 

62507 

1896 new 

224927 

1 min 45 sec ago 

by WorldFallz 

Before you start 

Is Drupal a viable solution for my website? Please see the 
documentation Before you start before posting. 

3408 

89 new 

14320 

5 hours 29 min ago 
by hanen 

Installing Drupal 

Installing Drupal? Please see the documentation in the handbook and 
the video resources for Drupal 5 and Drupal 6 for additional installation 

resources. 

9296 

158 new 

39469 

34 min 29 sec ago 
by fsirett 

Upgrading Drupal 

Questions regarding upgrading an existing Drupal site. Don't forget to 
read the UPGRADE.txt that comes with evey Drupal download. 

2748 

66 new 

11049 

59 min 23 sec ago 

by Helenrf 


< Vote 2008 Best Overall 
CMS 

• Create content 

• Issues 

> My projects 

> My account 

i Recent posts 

• News aggregator 
■ Administer 

» Log out 


Search | 


1 Advanced search 
' Queues 
. My issues 


The final step in configuring Forums involves adjusting the Settings, as indicated 
by Item 3 in the screenshot before the preceding one, and as shown in the 
following screenshot: 
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Forums and Blogs 


The forum settings consist of three options: 

• Hot topic threshold: This indicates the number of comments in a thread 
required for a post to be considered more active than others. These posts 
can be displayed in the Active forum topics block, which can be enabled by 
clicking on the Administer | Site building | Blocks link, or by navigating to 
ad mi n/bui I d/bl ock. 

• Topics per page: This indicates the number of posts displayed on the forum 
overview page. The default (25) makes sense, as 25 posts can be displayed on 
a single screen on most monitor resolutions. 

• Default order: This indicates the order in which posts are displayed. 
Although the best setting is subjective, displaying the newest posts first 
allows the more recent conversations to be highlighted, which can help 
discussions on a site gather and maintain momentum over time. 

After you have made all necessary adjustments to the settings, click the Save 
configuration button to save your settings. 

Displaying Multiple Content Types in a 
Forum 

Within Drupal, forums are actually organized using a taxonomy. When the 
Forum module is enabled, a new Forums vocabulary is created. This vocabulary 
can be edited in the usual way, as described in Chapter 3, by clicking on the 
Administer | Content management | Taxonomy link, or by navigating to 
ad mi n/content/taxonomy. 

By clicking on the edit link, you can adjust what content types are displayed within 
your forums. 

This feature can be very useful in a site that manages a single class, or in a site where 
forums are the primary vehicle for organizing communication. However, if we use 
a combination of forums, blogs, and groups alongside each other, it can become 
confusing for site users. 

Assign Permissions to Forums 

To assign permissions for forums, click on the Administer | User management | 
Roles link, or navigate to ad mi n/user/rol es. We will be adjusting permissions for 

the Teacher and Student roles. 
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forum module 

administer forums 

□ 

create forum topics 

0 

delete any forum topic 

_ □ 

delete own forum topics 

□ 

edit any forum topic 

□ 

edit own forum topics 

0 


The forum module has six permissions: 

• administer forums 

• create forum topics 

• delete any forum topic 

• delete own forum topics 

• edit any forum topic 

• edit own forum topics 

Of these six permissions, only one, create forum topics, is a must-assign for site 
users. Additionally, most users will probably want to be able to edit own forum 
topics. However, it's worth considering that if a user edits a forum post after a 
comment has been made, the context of the comment, and the subsequent discussion, 
will be lost. For this reason, we generally recommend only assigning the ability to 
edit any forum topic —and either of the delete privileges—to very trusted users. 

Once you have assigned the desired rights to both the Student and Teacher roles, 
click the Save permissions button to save the settings. 

The Relationship between Forums and 
Blogs 

Forums and blogs both support interactive, threaded discussions between users. 
However, many users report that conversations within blogs "feel different" than 
conversations within forums. In general terms, forums feel more group-centric, and 
blogs feel more individual-centric. 
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Within Drupal, however, these paradigms can be shifted. For example, the taxonomy 
module and use of keywords allows blog posts to be organized in the same way as 
forum posts; within groups (discussed in Chapter 12: Supporting Multiple Classes), 
blog topics can feel more like a forum. In the rest of this chapter, we will look at some 
of the ways in which these modes of discussion differ, with an eye toward helping 
clarify how and when to use each tool for the greatest effect. 

Forums 

Forums are among the oldest of the online communication tools, as they have their 
roots in tools that have been around since the 1970's. Traditionally, forums provide 
a place for group members to come together to discuss specific issues and questions; 
within a classroom, this provides their greatest strength and greatest weakness. 

For more information on the history of online forums and discussion boards, 
Wikipedia provides an excellent overview: http://en.wikipedia.org/wiki/ 

Bui I eti n_board_system. 

Strengths 

As discussed in this chapter, forums provide a "place" for people to go to ask 
question. Because forums are usually organized around specific topics, when you're 
there, you have context about what you are supposed to be discussing. Particularly 
with younger students, or less tech-savvy students, this level of structure can be both 
comforting and useful. 

Forums can be very useful as a place for offering support, or for posting 
announcements. Because these needs are largely recurring, the structure of a forum 
provides an ideal place to publish and store such information. 

Additionally, because discussions in forums typically play out over time, 
the discussion can be more gradual. This offers the potential for more 
thoughtful discussions. 


Concerns 

In an online course, forums can feel repetitive when used alongside blogs. 
Traditionally, forums existed as part of a larger website, or as the primary means 
of communication within a course. When other methods of communication exist, 
the multiplicity of options can become confusing for the end user, and can end up 
fragmenting the conversation. This is particularly true when using blogs, groups, 
and forums within the same site. 
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Blogs 

When compared to forums, blogs are relatively new, having risen to prominence 
and popularity in the 1990's. For an overview of how blogging has developed over 
time, refer to the History of Blogging Timeline at http: lie n. wi ki pedi a. org/wi ki / 

Hi story_of_bl oggi n g _ t i me I i ne. 

Strengths 

Blogs are ideally suited as a tool for personal reflection, as blogs feel more centered 
around a person and their ideas. Additionally, other classroom activities can be used 
to transition into reflective blog postings; for example, ideas raised in response to a 
chat prompt can be explored fully within a blog post. 


Concerns 

When compared to forums, the decentralized nature and individual focus of blogs 
feels less conducive to community building. Within a Drupal-based course site, 
however, where some blogging occurs within a course, and blogs can be tagged with 
community-generated keywords, this is mitigated to some extent. 

Summary 

Blogs and forums both support communication. The differences between blogs and 
forums are fairly subjective, and the "best" choice often revolves around issues more 
closely attached to style than substance. Because of these similarities, using blogs and 
forums within the same site can get confusing. 

If you have multiple courses on one site (which we will cover in Chapter 12: 
Supporting Multiple Classes), you might want to use forums for more general 
discussions across all courses, and use blogs as the means for managing discussions 
for a single courses. In this situation, people know that to communicate for a specific 
course, they use a blog, and to communicate outside of the context of a specific 
course, they use a forum. 

However, in the absence of a clear distinction between blogs and forums, we 
recommend using either a blog or a forum. This can lead to a site that is easier to use, 
which in turn contributes to a better learning experience. Whatever choice you make 
in structuring your course, be sure that you can explain the rationale behind it to 
your students. 


[ 221 ] 


[packtI 

L PUBLISHING J 


This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 





Forums and Blogs 


For those of you who want additional information and insight on using blogs and 
forums, Donna Cameron and Terry Anderson published the results of an academic 
research study entitled Comparing Weblogs to Threaded Discussion Tools in Online 
Educational Contexts, in the International Journal of Instructional Technology and Distance 
Learning. The full text of the article is available at h 11 p : / / www, itdl.org/journal/ 
Nov 06/arti cle01.htm. 
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Social Networks and 
Extending the User Profile 


The term "social network" means different things to different people. However, the 
starting point of any network is the individuals within it. A user profile provides a 
place for site members to describe themselves, and for other site members to find 
out about them. In this chapter, we will examine how to create a user profile that is 
aligned with the goals of your site. 


Identifying the Goals of Your Profile 

User profiles can be used for a range of purposes. On one end of the spectrum, a 
profile can be used to store basic information about the user. On the other end of the 
spectrum, a user profile can be a place for a user to craft and share an online identity. 
As you create the functionality behind your user profile page, you should know the 
type of profile you want to create for your users. 

Drupal ships with a core Profile module. This module is a great starting point, and 
for many sites will provide all of the functionality needed. 

If, however, you want a more detailed profile, you will probably need to take the 
next step: building a node-based profile. This involves creating a content type that 
stores profile information. Node-based profiles offer several practical advantages; 
these nodes can be extended using CCK fields, and they can be categorized using 
a taxonomy. In Drupal 6, user profiles become nodes through using the Content 
Profile module. 

The most suitable approach to user profiles will be determined by the goals of your 
site. Using Drupal's core Profile module provides some simple options that will be 
easy to set up and use. Extending profiles via the Content Profile module allows for a 
more detailed profile, but requires more time to set up. 
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In this chapter, we will begin by describing how to set up profiles using the core 
Profile module. Then we will look at how to use the Content Profile module. 

Using the Core Profile Module 

To use the core profile module, click on the Administer | Site building | Modules 
link, or navigate to a d mi n / b u i I d / mo d u I e s . In the Core - optional section, enable the 
Profile module. Click the Save configuration button to submit the form and save 
the settings. 

Once the Profile module has been enabled, you can see a user's profile information 
by navigating to http: //ex a mp I e, com/user/UI D, where UID is the user's ID 
number on the site. To see your own user profile, navigate to http: / /exampl e. com/ 
user when logged in, or click the My Account link. 



The default user profile page exposes some useful functionality. First, it shows 
the user's profile, and secondly, it provides the Edit tab that allows a user to edit 
their profile. The Edit tab will only be visible to the owner of the profile, or to 
administrative users with elevated permissions. 

-[ 224 ]- 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 


























Chapter 11 


Other modules can add tabs to the core Profile page. As shown in the preceding 
screenshot by Item 1, the core Tracker module adds a Track tab; this tab gives an 
overview of all of the posts to which this user has participated. The Tracker module 
is discussed in more detail in Chapter 13: Tracking Student Progress. 

As shown in the preceding screenshot by Item 2, the Contact tab has been added by 
the core Contact module. The Contact module allows users to contact one another via 
the site. 

Customizing the Core Profile 

The first step in customizing the user profile requires us to plan what we want the 
profile to show. By default, Drupal only requires users to create a username and 
provide an email address. From a user privacy perspective, this is great. However, 
for a teacher trying to track multiple students across multiple classes, this can be less 
than useful. 

For this sample profile, we will add two fields using the core Profile module: 

a last name, and a birthday. 

The admin features for the core profile module are accessible via the Administer | 
User Management | Profiles link, or you can navigate to ad mi n/user/profi I e. 


Packt and Drupal 


Search this site: 


J | Search 1 


bill 

° My account 
P Create content 
° Recent posts 
Administer 

0 Content management 
P Site building 
P Site configuration 
v User management 
° Access rules 
o Permissions 
° Profiles 
° Roles 
° User settings 
° Users 
P Reports 
° Advanced help 
° Help 
° Log out 


Home > Administer > User management 


Profiles 


This page displays a list of the existing custom profile fields to be displayed on a user's My Account page. To 
provide structure, similar or related fields may be placed inside a category. To add a new category (or edit an 
existing one), edit a profile field and provide a new category name. To change the category of a field or the 
order of fields within a category, grab a drag-and-drop handle under the Title column and drag the field to a 
new location in the list. (Grab a handle by clicking and holding the mouse while hovering over a handle icon.) 
Remember that your changes will not be saved until you click the Save configuration button at the bottom of 
the page. 


[more help...] 


Title Name 

No fields available. 

Add new field 

° single-line textfield 
° multi-line textfield 
° checkbox 
° list selection 
° freeform list 
o URL 
° date 
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As seen in the preceding screenshot, the core profile module offers the following 
possibilities for customization: 

• single-line textfield — adds a single line of text; useful for names or other 
types of brief information. 

• multi-line text field — adds a larger textarea field; useful for narrative-type 
profile information. 

• checkbox —adds a checkbox; useful for Yes/No options. 

• list selection — allows the site admin to create a set of options; the user can 
then select from these pre-defined options. Functionally, this is similar to a 
controlled vocabulary created using the core Taxonomy module. 

• freeform list — adds a field where the user can enter a comma-separated list. 
Functionally, this is similar to a tag-based vocabulary created using the core 
Taxonomy module. 

• URL — allows users to enter a URL; this is useful for allowing users to add a 
link to their personal blog. 

• date — adds a date field. 

In our example profile — adding a last name and a birthday—our last name will be a 
single-line textfield; our birthday will be a date field. 

Add a Last Name 

Let's start by clicking on the Administer | User Management | Profiles link, or by 
navigating toadmin/user/profile, and then clicking the single-line textfield link. 
This brings you to the following link: ad mi n/user/profi le/add/textfiel d. 

For reasons of clarity, we will break up the administrative form used for adding 
profile fields. The first half is shown in the following screenshot: 
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• Category: All custom profile fields need to belong to specific categories. 

This field allows you to create new categories, and assign your new fields to 
these categories. 

• Title: The Title will be presented to the user when they are completing the 
profile form. The value here should be short, and should make sense. 

• Form name: This value is stored within the database, and is exposed in some 
administrative screens. The form name should also be unique. To avoid any 
naming conflicts with the names of other fields on other forms, these fields 
should always begin with p r o f i I e _. 

• Explanation: The explanation is presented to the person as they are 
completing or editing the form. Explanations are optional. 
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The following screenshot shows the remaining options on the form: 


Visibility: 

O Hidden profile field, only accessible by administrators, modules and themes. 

O Private field, content only available to privileged users. 

O Public field, content shown on profile page but not used on member list pages. 

0 Public field, content shown on profile page and on member list pages. 

Page title: 

To enable browsing this field by value, enter a title for the resulting page. The word %value will be substituted with the 
corresponding value. An example page title is "People whose favorite color is %value". This is only applicable for a public field. 

Weight: 

1° Mil 

The weights define the order in which the form fields are shown. Lighter fields "float up" towards the top of the category. 

□ Form will auto-complete while user is typing. 

D The user must enter a value. 

0 Visible in user registration form. 

[ Save field ] 


• Visibility: This setting allows you to determine who can see the value users 
enter into this field. 



In addition to the privacy settings here, access to user profiles can also 
be toggled ON or OFF for user roles via the permissions for the User 
module; only roles with access user profiles permissions can see user 
profiles. These permissions can be edited via the Administer | User 
management | Permissions link, or by navigating to admi n / user / 
per mi s s i ons. 


• Page Title: If a field is set to public, you can use the Page title to set up a 
page where all users are displayed. The next section of this chapter — Using 
Content Profile — covers a different method for accomplishing this goal. 

• Weight: This field governs the order in which fields are displayed. These 
weights can be overridden using a drag and drop interface once all of the 
fields have been added; refer to the following screenshot for details. 
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For the last name field, the above values should be set as shown in the last two 
screenshots. These values are also listed below: 

• Category: Personal Info 

• Title: Last name 

• Form name: profile_last_name 

• Explanation: Enter your last name 

• Visibility: Public field, content shown on profile page and on member 
list pages 

As discussed in the prior section, the visibility of these fields is a 
preference. If you are unsure of what to share between your users, start 
with a more restrictive selection. From the perspective of your users, 
adding functionality or options is easier to do than removing them, as 
people will often miss a feature once it has been removed. 

• Page title: leave blank. 

• Weight: -1 

When you have adjusted these settings to your desired preferences, click the Save 
field button to submit the form and save your changes. 

Add a Birthday 

Adding the birthday field is nearly identical to adding the last name field. 

Let's start by clicking on the Administer | User management | Profiles link, or by 
navigating toadmin/user/profile, and then clicking the date link. This brings you 
to ad mi n/user/profi le/add/date. 

Form Options 

• Category: Personal Info 

0 This field will be grouped with the Last name field added in 
the last section 

• Title: Birthday 

• Form name: profile_dob 

• Explanation: Please enter your date of birth 

• Visibility: Private field, content only available to privileged users 
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• Weight: 0 

° This is set to a value lower than the Last name field, so that the 
Birthday field will be displayed below the Last name field 

When you have adjusted these settings to your desired preferences, click the Save 
field button to submit the form and save your changes. 

Managing Your Profile Fields 

When you have created your profile fields, you can manage them by clicking on the 
Administer | User Management | Profiles link, or by navigating to a d mi n / user/ 
p r o f i I e , as shown in the following screenshot: 


Home > Administer > User management 

Profiles 

The field has been created. 

This page displays a list of the existing custom profile fields to be displayed on a user's My Account page. To 
provide structure, similar or related fields may be placed inside a category. To add a new category (or edit an 
existing one), edit a profile field and provide a new category name. To change the category of a field or the 
order of fields within a category, grab a drag-and-drop handle under the Title column and drag the field to a 
new location in the list. (Grab a handle by clicking and holding the mouse while hovering over a handle icon.) 
Remember that your changes will not be saved until you dick the Save configuration button at the bottom of 
the page. 

[more help...] 


Title Name Type Operations 

Personal Info 


❖ 

Last name 

profile_last_name 

textfield 

edit 

delete 


Birthday 

profile_dob 

date 

edit 

delete 


[ Save configuration ] 

Add new field 

o single-line textfield 
° multi-line textfield 
° checkbox 
° list selection 
0 freeform list 
° URL 
° date 


The edit link allows you to adjust the settings of the individual fields, and the order 
of the fields can also be rearranged via drag and drop. 
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Adding Content to a Profile Created Using the 
Core Profile Module 

Users can edit their profile by clicking the My Account link, then the Edit tab, and 
finally the Personal Info tab, as shown in the following screenshot: 


y 

m Packt and Drupal 



Moving Beyond the Core Profile Module 

The core profile module is a useful tool for gathering and displaying basic 
information. However, for more detailed profiles it can become difficult to use. Using 
a content type to extend user profiles allows us to create more detailed user profiles. 
Also, using a content type allows us to use CCK to add different types of fields to 
a profile. 

When to Look Beyond the Profile Module 

1. You want to have a blend of public and private information, and you want 
the public information to be searchable. 

2. You want to have a range of checklists, option buttons, text fields, images, 
and/or user interests on your profile. 
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3. You want more flexibility in what your users can share and display, and you 
want to set up pages where people can find other people based on interests, 
likes, dislikes, and so on. 

There are multiple options for how to extend user profiles, to the extent that there is 
an entire group devoted to discussing itathttp: / /groups, drupal . org/profi I e s - 
as-nodes. 

Extending Profiles Using the Content 
Profile Module 

To extend user profiles, we will use the Content Profile module available at 
http://drupal. org/proj ect/content_profiI e. 

The Content Profile module can be enhanced by using the Automatic Nodetitles 
module available at http: / /drupal . o r g / proj ect / aut o_nodet i tl e. Automatic 
Nodetitles uses the Token module, which we installed in Chapter 8. Used together, 
these three modules provide a simple and effective way to extend your user profiles. 

When using the Content Profile module in conjunction with the core profile module, 
one simple technique for extending profiles involves using the core profile module to 
store private information (that is, all of the fields created using the profile module 
are private or hidden), and the Content Profile module to store and organize the 
public profile. 

To begin, install the Content Profile, Token, and Automatic Nodetitles modules as 
described in Chapter 3. Obviously, if the Token module is already installed, you only 
need to install the other two modules. 

The Content Profile module comes with the Content Profile User 
Registration module; the User Registration module allows selected fields 
to be presented to the user when they are registering. This module is 
covered later in this chapter. 

Once these modules are installed, we are ready to begin building our 
extended profile. 
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Building the Profile 

The Content Profile module creates a new content type called Profile when it is 
enabled. By default, this content type is set to be used as a profile. We need to 
complete a few additional steps to make our profile fully functional. 

1. Edit the default settings for the Profile content type 

2. Configure the base Content Profile settings 

3. Add any required fields to the Profile content type 

4. Add any taxonomy terms to the Profile content type 

5. Assign rights to create and edit the Profile content type 

Edit the Settings of the Profile Content Type 

As mentioned above, when the Content Profile module is enabled, it creates a new 
content type named Profile. To use this new node type effectively, we need to change 
the default settings. 

To do this, click on the Administer | Site building | Content types link, or navigate 
to ad mi n/content/types. Click the Edit link for the Profile content type. 

The Automatic Nodetitles module — enabled earlier in this chapter —adds a new 
fieldset labelled Automatic title generation at the top of the administrative screens 
where we edit content types. 
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As shown in the preceding screenshot, we have two options. For the first option, we 
want to select Automatically generate the title and hide the title field. 

For the second option— Pattern for the title —we should enter [author-na me ] ' s 
profi I e.[author-na me ] is a token; when the node is created, the token will be 
replaced by the username of the person creating the node. So, if a user named Jill 
created the profile node, the title would be Jill's profile. 

The Token module allows us to use a wide range of tokens in addition 
to [ a u t h o r - n a me ] . To see the full list of available tokens, expand the 
Replacement patterns fieldset as indicated in the preceding screenshot 
by Item 1. 

The settings listed here also need to be adjusted: 

• In the Submission form settings section, delete the Body field label. We do 
not want this node type to have a body field; we will add all needed fields 
using CCK. 

• In the Workflow settings section, set the Default options to Published, and 
Attachments to Disabled. 

• In the Comment settings section, set the Default comment settings 

to Disabled. 

After you have made the necessary adjustments, click the Save content type button 
to submit the form and save your changes. 

Configure the Base Content Profile Settings 

To configure the base Content Profile settings, click on the Administer | Site 
building | Content types link, or navigate to ad mi n/content/types. Click the Edit 
link for the Profile content type. Then, click the Content Profile tab. 
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The base settings allow us to configure how the node profile will be displayed on the 
user profile page. As shown in the preceding screenshot, in the User page display 
style section we have four options: 

• Don't display this content profile on the user account page — only select 
this option if you will be overriding the core user profile page via the 
theming layer. This is an advanced theming technique; refer to Chapter 14: 
Theming and User Interface Design; additionally, refer to the handbook page on 
overriding user profiles athtt p: / / drupal . org/node/ 35728. 

• Display it as link to the profile content —select this option if you only want 
to link to the full profile node from the user profile page. 

• Display the full content— this option displays the full node on the user 
profile page. 
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• Display the content's teaser— this option displays the teaser view on the 
profile page. As discussed later in this section, this option provides us 
some flexibility not found in the other options. For our example, choose 
this option. 

The final two options — Include an edit link to the display and Show a link to the 
content profile creation page, if there is no profile — should both be selected, as they 
improve usability. 

The Weight can be left at 0. 

When these settings have been adjusted as needed, click the Submit button to save 
the changes. 

Add Fields to the Profile Content Type 

Now that we have edited the defaults of the Profile node type, and adjusted the base 
settings of the Content Profile, we are ready to add fields and taxonomy terms to our 
profile. The CCK fields and Taxonomies will provide structure to our user profiles. 

For this example, we want to extend our profile by adding two fields, and 
one vocabulary. 

The fields we will add will both be text fields; one for a Brief bio, and the second for 

a Full bio. 

We will also add a Vocabulary to the Profile content type called Interests. Adding this 
vocabulary is covered in the next section of this chapter. 

Add the Brief Bio Field 

To add the text fields, go to the Content Types administration page by clicking the 
Administer | Content Management | Content Types link, or by navigating to 
ad mi n/content/types. Click the manage fields link for the profile content type. 

In the Add section, we want to add a New field. Enter the following values: 

• Label: Brief bio 

• Field name: briefjbio 

• Field type: text 

• Widget type: text area (multiple rows) 
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Click the Save button; this brings up the admin screen where you can configure 
the field. 


Profile settings 

These settings apply only to the Brief bio field as it appears in the Profile content type. 

Rows: * 

H 


Help text: 



Allowed HTML tags: <a> <fc» <big> <code> <del> <em> <i> <ins> <pre> <q> <small> <span> <strong> <sub> <sup> <tt> <ol> 
<ul> <li> <p> <br> <img> 

The ID for excluding or including this element is: edit-description - the path is: admin/content/node-type/profile/fields 
/field_brief_bio 

o Default value 


Global settings 

These settings apply to the Brief bio field in every content type in which it appears. 

□ Required 

Number of values: 

U a§l 

Maximum number of values users can enter for this field. 

'Unlimited' vail provide an 'Add more' button so the users can add as many values as they like. 

Warning! Changing this setting after data has been created could result in the loss of data! 

Text processing: 

® Plain text 

O Filtered text (user selects input format) 

Maximum length: 

1500 | 

The maximum length of the field in characters. Leave blank for an unlimited size. 

o Allowed values 


[ Save field settings ] 


As shown in the preceding screenshot, the form to configure the text field has two 
sections: Profile settings and Global settings. 
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Adjusting the Profile Settings 

In the Profile settings, we have two options; enter the values specified below: 

• Rows: 3 

• Help text: Enter your brief bio. 500 characters maximum. 

For this example, we do not need to set any Default value. 

Adjusting the Global Settings 

In the Global settings, we have four options; enter the values specified below: 

• Required: No; leave unchecked 

• Number of values: 1 

• Text processing: Plain text 

• Maximum length: 500 

For this example, we do not need to set any Allowed values. 

Once the field has been configured as needed, click the Save field settings button to 
save your changes. 

Adding the Full Bio Field 

Adding the Full Bio is nearly identical to adding the Brief bio. When adding the field, 
use the following values: 

• Label: Full bio 

• Field name: fulljbio 

• Field type: text 

• Widget type: text area (multiple rows) 

Click the Save button; this brings up the admin screen where you can configure 
the field. 

In the Profile settings, enter: 

• Rows: 5 

• Help text: Enter your full, extended biography. 


[ 238 ] 


[PACKTl 

L PUBLISHING J 


This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 





Chapter 11 


In the Global settings, we enter: 

• Required: No; leave unchecked 

• Number of values: 1 

• Text processing: Filtered text (user selects input format) 

• Maximum length: none, leave blank 

Once the field has been configured as needed, click the Save field settings button to 
save your changes. 

Adjusting the Field Display 

As we discussed above when we configured the base options for Content Profiles, 
we want to show the node teaser on the user profile page. To take advantage of this 
option, we need to configure how we display our fields. To do this, go to the Content 
Types administration page by clicking the Administer | Content Management | 
Content Types link, or by navigating to ad mi n/content/types. Click the edit link 
for the profile content type, and then, click the Display fields tab. 



As seen in the preceding screenshot, you can control how fields are displayed in the 
Teaser view and in the Full node view. 

In the settings shown in the preceding screenshot, we have set the Brief bio to show 
on the Teaser view (that is, on the user profile page), and the Full bio to display on 
the Full node view (that is, when the entire profile is being viewed). Our settings 
display a truncated overview on the user profile page, with a link to the more 
detailed full node view. 
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Add Taxonomy Terms to the Profile 
Content Type 

As described above, we want to add an Interests vocabulary. 

To add new vocabularies, click on the Administer | Content management | 
Taxonomy link, or navigate to ad mi n/content/taxonomy. Click the 

Add vocabulary tab. 

Adding the Interest Vocabulary 

For Interests, enter the following values: 

• Vocabulary name: Interests 

• Description: none, leave blank 

• Help text: Describe your interests. Separate each interest with a comma 

• Content types: select Profile; leave others unchecked 

• Settings: select Tags; leave others unchecked 

• Weight: -6 

Click the Save button to create the new vocabulary. 

Assign Rights to Profile Nodes 

Click on the Administer | User Management | Roles link, or navigate to 
admin/user/roles. Select the role(s) that you would like to be able to create 
node-based profiles. Generally, users should be given the rights to create profile 
content, and edit own profile content. This will allow users to create their own 
profiles, and update them as needed, but also protects users from accidentally 
deleting their profile. 

Only site administrators or especially trusted users should be given the rights to edit 
any profile content or delete any profile content. 
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Creating an Extended Profile 

Now that we have made all of the necessary adjustments to the Profile content type 
and the Content Profile settings, we are ready to have users populate their profiles. 

Users can fill out their profiles by navigating to their profile page, either by clicking 
on the My Account link or by navigating to http: / /examp le.edu/user when they 
are logged in. If a user has not completed their profile, they will be presented with a 
link to complete it. 



This screenshot is taken from the perspective of the profile owner; that is, this profile 
is owned by user helen, and this screenshot was taken while the user was logged in 
as helen. 
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As shown in the preceding screenshot, the Last name and Birthday fields we created 
earlier in this chapter are visible. The Create your Profile link is displayed because 
the user Helen has yet to complete her profile. Clicking the Create your Profile link 
allows us to fill in the form. 



As shown in the preceding screenshot, our profile contains textareas for the Brief 
and Full bio, as well as a vocabulary for Interests. Additionally, the Title field on the 
form is hidden, as we specified via the Automatic Nodetitles settings. 

When you have entered the appropriate values, click the Save button to create the 
extended profile. 


[ 242 ] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 






























Chapter 11 


Including Fields from the Profile Node on the 
Registration Form 

If you would like to include any of the fields from the node-based profile on the user 
registration form, you will need to enable the Content Profile User Registration 
module. As mentioned earlier in this chapter, this module ships with the Content 
Profile module; like all modules, it can be enabled at Administer | Site building | 
Modules, or a d mi n / b u i I d / mo d u I e s. 

Once the module has been enabled, we will need to access the base Content Profile 
settings by clicking on the Administer | Site building | Content types link, or by 
navigating to ad mi n/content/types. Click the Edit link for the Profile content type, 
and then, click the Content Profile tab. 
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The Content Profile User Registration module adds the User Registration fieldset. 
To compare this form before Content Profile User Registration has been enabled, 
see the Profile screenshot earlier in this chapter under the section Configure the Base 
Content Profile Settings (refer to page number 238). 

To show fields on the new user registration form, select the Use on Registration 
option, and then select all the fields that you DO NOT want to show on the form. 
The default is to show fields on the form. 

Once you have configured the settings to your desired specifications, click the 
Submit button to save these settings. 

Additional Options for Social Networking 
and User Profiles 

In many social networking sites, people often want to allow users to "become 
friends" with one another. Although the advisability of this type of interaction in 
a classroom setting is a matter of much debate, this functionality can be delivered 
through two different modules: User Relationships and Friendslist, available at 
http://drupal. org/proj ect/user_rel ati onshi ps and http://drupal.org/ 
proj ect/fri e n d I i st, respectively. These two modules achieve similar goals, and it 
is not inconceivable that, over time, one of these modules will supersede the other. 
As of this writing (October, 2008), however, both modules are actively supported. 

Another module that is worth checking is the Advanced Profile Kit, available at 
http://drupal . org/proj ect / advanced_prof i I e. This module provides a set of 
tools for building and theming complex user profiles. 

Additionally, if you want to work directly with the theming layer, the possibilities 
for user profiles are virtually limitless. For more information on using the 
theming layer, refer to Chapter 14: Theming and User Interface Design. Additionally, 
you can find excellent information in the theming section of the Drupal handbook 
athttp://drupal , org/theme-gui de and the handbook page on overriding user 
profiles athttp://drupal . org/ node/ 35728. 
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Summary 

In this chapter, we looked at how to build user profiles using the core Profile 
module, and then how to extent the user profile using the Content Profile module. 
The best solution for you will certainly be determined by the goals that you want to 
achieve in your site. 

A well-constructed user profile allows people to express areas of personal interest 
and learn details about other site members. While this is not necessary in all class 
settings, in contexts where this is appropriate, a detailed user profile can provide a 
starting point for site members to have more personal investment in the site. 

The techniques covered in this chapter allow you to build effective user profiles that 
address a broad range of needs. Through judicious use of the theming layer, or by 
using other contributed modules shared onDrupal . o r g , more can be done with user 
profiles. In short, building an effective user profile allows your users to have some 
fun, and learn about one another in the process. 
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Supporting Multiple Classes 


Unless you are blessed with a large salary for a light teaching load, at some point it 
will become necessary to support more than one class within your site. In Drupal, 
courses can be organized as teacher-centered groups, or as less-hierarchical learning 
communities. Moreover, by creating different types of groups, we can support both 
types of learning within the same site. 

In Drupal, group functionality comes with the Organic Groups module. This 
module, along with related modules that extend its functionality, allow us to set up 
focused workspaces within a website. 


Install and Configure Organic Groups 

To get started with Organic Groups, we will download and install two modules: 
Organic Groups and OG Vocabulary, available athttp://drupal .org/project/ 
og_vocab and http://drupal.org/project/og_vocab, respectively. Download 
these modules and upload them to your server as described in Chapter 3. 



Throughout this chapter, we will abbreviate Organic Groups to OG. This 
abbreviation occurs frequently in discussions of Organic Groups that 
occur on drupal . org. 

The Organic Groups module works closely with many other modules. 

In this book, we will focus on the base Organic Groups module, and the 
OG Vocabulary module. However, other modules worth examining in 
connection with Organic Groups include the Panels module and the 
Notifications module, available athttp: / / drupal , org / proj e c t / 
panels and http://drupal.org/project/notifications, 
respectively. For a full list of the modules that extend Organic Groups, see 
http://drupal . org/proj ect/Modul es/category/90. 
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Organic Groups comes with a suite of modules. To get started, we need to enable 
some of these modules, along with the OG Vocabulary module. 



As shown in the preceding screenshot, you should enable the following modules: 

• Organic groups 

• Organic groups access control 

• Organic groups Views integration; this module requires the Views 
module, which we have already installed. 

• Organic groups vocabularies; this is provided by the OG Vocabulary 
module — all other modules are part of the Organic groups module. 

Click the Save configuration button to save your settings. 
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Upon enabling the Organic groups access control module, you will be prompted to 
rebuild the content access permissions, as seen in the following screenshot: 



Follow the link provided, and rebuild the permissions. Organic groups is now 
installed, and ready to be configured. 

Useful Links for Organic Groups 

Organic Groups interacts with many different areas of your site. As a result, some 
options are spread found other administrative areas. The following sections provide 
lists of useful places to know about when using Organic Groups. 

Administrative Links 

• Administer | Content management | Post settings, or ad mi n/content/ 
node-setti ngs: This admin screen exposes the button to rebuild the access 
permissions. Occasionally, it might be necessary to rebuild these permissions. 
The ability to rebuild access permissions is useful when using any access 
control module. 

• Administer | Content management | Content types, or ad mi n/content/ 
types: This is the administrative page for content types; now that Organic 
Groups is enabled, the main edit page for each content type has an Organic 
groups fieldset. The options contained in this fieldset are discussed at greater 
length later in this chapter when we cover working with content types while 
using Organic groups. 

• Administer | Organic groups | Organic groups configuration, 

or ad mi n/og/og: This admin screen contains three fieldsets. These options 
are discussed in greater detail later in the chapter, but in brief are: 

° Content types, which allows us to determine how content 
types are used within OG. This page links to the same 
functionality exposed in the Content types settings at 
admin/content/types, as described earlier. 

° Group details, which allows us to control the defaults for 
that are presented to users when they register for the site, 
whether groups appear in the group directory, and other 
general options. 
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° Email settings, which allow us to specify the default text for 
system emails sent as part of Organic groups. 

• Administer | Organic groups | Organic groups access configuration, or 

ad mi n/og/og_access: The options on this page allow us to set the default 
privacy levels of group home pages (that is, the landing page of a group) 
and of posts within those groups. The options on this page are discussed in 
greater detail later in this chapter. 


Navigation Links 

The navigation links are added into the main navigation menu by the OG Views 
integration module; if this module is not enabled, these menus will not exist. 



The screenshots in this section are taken with content already added to 
the site. OG does not ship with content already installed. Although the 
menus and pages here exist in the default installation, you need actual 
groups and group content to see how they work. Over the course of this 
chapter, we will add content that will flesh out these pages. 


Finding Groups and Navigating Group Content 

The first menu item. Groups, provides easy access to three default screens for finding 
groups and navigating group content: The Groups directory. My groups, and 
Group activity. 


Home Assignment calendar Drupal 


Packt and Drupal Open Source Goodness 


Search this site: 


sally 

1 Groups 4 
° My Unread 
° My account 
° Recent posts 
° Student blog 
° Teacher blog 
° Log out 


Groups 

Search for a group by name 


3 4 

My groups Group activity 




Apply 


Groups Description Managers Posts'^" Members^ Join Link 

Algebra II Algebra II, Second period, with Ms. Jones sa || y i 2 


□ 
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The Groups directory can be accessed by clicking the Groups menu (shown by 
Item 1 in the preceding screenshot), or by navigating to o g. As shown in the 
screnshot, the directory contains three tabs: Groups, My groups, and Group activity. 

The Groups tab (shown by Item 2 in the preceding screenshot) provides a searchable 
list of all groups that are visible in the directory. As discussed earlier in the chapter, 
groups can be included in or excluded from the directory at the discretion of the site 
administrator or the group manager. 

The My groups tab (shown by Item 3 in the preceding screenshot) contains a list of a 
user's groups, with links to manage group subscriptions. 

The Group Activity tab (shown by Item 4 in the preceding screenshot) provides an 
overview of posts and comments that have taken place in your groups. 

All of these screens are generated by custom views that ship with OG, and are 
activated as part of the Organic Groups Views Integration module. If you want 
to change the appearance of any of these pages, you can edit the view that 
created them. 

My Unread Posts 

The second menu item added by the OG Views integration module is the My unread 
menu. This menu provides easy access to a series of pages that track comments and 
discussions occurring within a site. 


y 

Drupal 


Home 


Add content 


Unread posts in my groups 

My recent Recent posts 


Create groups 

2 

Group 

3 

Type 

Title 

4 

Author Replies Last Post^ 

0 Club 

Algebra 

II 

Assignment 

Read Chapter 1 

new 

24 min 50 sec 

sally 0 

ago 


New groups 

° Algebra II 

My Network 

° bill 
° sally 


jimmy 

° Groups 

° My unread 1 

° Recent posts • • • • 5 

0 My account 
0 Log out 
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To access the My unread posts page, click the My unread link (shown by Item 1 in 
the preceding screenshot), or navigate to g r o u p. 

The My unread page (shown by Item 2 in the preceding screenshot) lists all posts in 
a user's groups that the user has not read. This page provides a central place where 
users can go to see all new content and comments in their different groups. 

The My recent tab (shown by Item 3 in the preceding screenshot) provides a lists of 
all content, both read and unread, in a user's groups. 

The Recent posts tab (shown by Item 4 in the preceding screenshot) shows all recent 
posts made on the entire site, regardless of whether or not they are connected with 
a group to which the user belongs. 



The Recent posts tab duplicates the functionality of the core Tracker 
module and its Recent posts menu (shown by Item 5 in the preceding 
screenshot). In order to avoid confusion, on sites where Organic groups 
is used, the Recent posts link provided by the Tracker module should be 
disabled via the admin menu at Administer | Site building | Menus, or 
by navigating to admi n / bui I d / me n u . For more information on working 
with menus, refer to Chapter 14: Theming and User Interface Design. For 
more information on the core Tracker module, refer to Chapter 13: 
Tracking Student Progress. 


Adjusting Your Site to Work with Organic 
Groups 

Now that we have installed OG, we need to make some configuration changes to use 
the group functionality effectively. As we make this shift, it will help if we adjust our 
perspective to think about content differently. Before we installed Organic Groups, 
content was created within the site and generally displayed via a view or a menu. 
Now, with OG installed, content is obviously still posted within the site, but it can 
also be contained within one or more groups. 

Moreover, groups are created using content types. As we configure Organic Groups, 
we will separate our content types into three distinct categories: 

• Content types that can be used to create groups 

• Content types that can be posted into groups 

• Content types that are never posted into groups 
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Once we have configured our content types to work with OG, we will examine the 
options for configuring individual groups. 

Create Group Types 

Once you have installed OG, you need to create content types for your groups. Click 

on the Administer | Content Management | Content Types link, or navigate to 
ad mi n/content/types. 

[C Creating content types is covered in detail in Chapter 3. 

We are going to create two new content types that we will use as groups: Class and 
Club. Functionally, these two content types will be identical. In this example, we 
will allow only the teacher role to create classes, and will allow both students and 
teachers to create clubs. Depending on how responsibilities are organized at your 
school or organization, both the names of your groups and the ability to create them 
can be adjusted to fit within your learning context. 

Creating the Class Content Type 

While at Administer | Content Management | Content Types, or ad mi n/content/ 
types, click the Add content type tab. 

For the Identification section, use the following values: 

• Name: Class. 

• Type: class. 

• Description: Create a class. 

• In the Submission form settings section, the Explanation or submission 
guidelines can be set to Describe your class. Use this section to link to a 
syllabus, or to other relevant information. 

• In the Workflow settings, set default settings to Published. 

• In the Comment settings section, set the default to Disabled. 
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The Organic Groups Fieldset 

As mentioned earlier, enabling OG creates an Organic groups fieldset on the various 
edit screens for individual content types at Administer | Content management | 
Content types, or a d mi n/content/types. The options in this fieldset allow us to 
define how content types interact with groups. 


w Organic groups 

Organic groups usage: 

® Group node 

O May not be posted into a group. 

O Standard group post (typically only author may edit). Sends email notifications. 

O Standard group post (typically only author may edit). No email notification. 

O Wiki group post (any group member may edit). Sends email notifications. 

O Wiki group post (any group member may edit). No email notification. 

Specify how organic groups should treat nodes of this type. Nodes may behave as a group, as group posts, or may 
not participate in organic groups at all. 


• Group node: This option allows you to specify a content type that will be 
used to create groups. 


[ 



When creating the Class and Club content types, we will select Group 
node because these node types will be used to create groups. 


1 


• May not be posted into a group: Selecting this option lets you omit specific 
content types from being used in groups. 

The remaining four options all affect content posted to a group. These settings 
allow you to select options controlling email notifications and a group wikis. 

These options are also described later in this chapter when we cover how to set 
up individual groups. 

• Standard group post (typically only author may edit). Sends email 
notifications: This setting allows you to specify that a content type can be 
used within a group, and that whenever this content type is posted within a 
group, an email will be sent to group members. Email notification should be 
used with caution, as it can result in large numbers of emails being sent to 
group members. 

• Standard group post (typically only author may edit). No email notification: 

With this option selected, email notifications will never be sent for this 
content type. 
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• Wiki group post (any group member may edit). Sends email notifications: 

Selecting this option allows you to create a group wiki, with email 
notification to group members when a new post is created. 

• Wiki group post (any group member may edit). No email notification: 

With this option selected, email notifications will never be sent for this 
content type. 

Once the new node type has been configured appropriately, click the Save content 
type button to create the new node type. 

Creating the Club Content Type 

Creating a Club node type is identical to creating the Class node type, as described 
above. The only elements that will differ are laid out below: 

For the Identification section, use the following values: 

• Name: Club. 

• Type: club. 

• Description: Create a club. 

• In the Submission form settings section, the Explanation or submission 
guidelines can be set to: Describe your club. Once you create your club, you 
can begin inviting other members. 



In some cases, you might want to require approval for groups. If you 
want to do this, you can set the default Workflow settings to unpublished, 
that is, with all options unselected. This way, people can create groups, 
but a site administrator will need to publish the groups before they 
become active. 


Click the Save content type button to create the Club node type. 


Assign Permissions to Group Nodes 

Now that we have created our node types that will create our groups, we need to 
assign permissions to allow users to create groups. In this example, we will allow 
teachers to create classes, and both teachers and students to create clubs. To set these 
permissions, click on the Administer | User Management | Roles link, or navigate 
to a d mi n / u s e r / r o I e s . 

To assign rights to specific roles, click the edit permissions link next to each role, and 
scroll down to the options for the node module. 
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Once you have installed OG on your site, you will probably want to 
create a Site Maintainer role with expanded rights, to administer content. 

For more information on creating roles and assigning rights via roles, 
refer to Chapter 3 and Chapter 5. 

For Class Nodes 

• The Teacher role should be assigned rights to create class content and edit 
own class content. 

• The Site Maintainer role (assuming one has been created) should be 
assigned rights to create class content and edit any class content. 

Delete rights for group nodes should be assigned very carefully. Deleting 
a group deletes all the posts within the group, and while there are a 
variety of screens and checks that a user will see before they can delete a 
group, these permissions should only be assigned to very trusted users. 

For Club Nodes 

• The Instructor and Student role should be assigned rights to create club 
content and edit own club content. 

• The Site Maintainer role (assuming one has been created) should be 
assigned rights to create club content and edit any club content. 

After assigning the appropriate rights to each role, click the Save permissions button 
to save your settings. 

Create a Menu for Groups 

Once you have created the Class and Club content types, you can increase the 
usability of your site by moving the links for creating classes and clubs into their 
own menu. 

Although this step is not necessary, confusion can arise because groups are also 
content types. A look at the default navigation menu, pictured in the following 
screenshot, helps illustrate why. 
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In the default navigation menu, all content types are grouped together in the same 
area. This can be confusing; although Club and Video are both content types, they 
do very different things to the other content types. 

Separating Group nodes into a separate menu and then displaying that block—as 
shown in the following screenshot —can help eliminate some of this confusion. 



The process of creating custom menus is described in detail in 
Chapter 14: Theming and User Interface Design. 


] 
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By separating Group nodes into a separate menu, you can provide a distinct place 
for people to go when they want to create groups. 

Setting the Defaults for Organic Groups 

So far, we have: 

• Installed OG and created group nodes 

• Assigned rights to be able to create and edit group nodes 

• Created a custom menu to make creating groups more intuitive 

Now, we need to configure the OG-specific settings. Click on the Administer | 
Organic groups link, or navigate to a d mi n / o g . As shown in the following screenshot, 
and as mentioned earlier in this chapter, there are two options: Organic groups 
configuration, and Organic Groups Access configuration. 
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Setting OG Configuration Options 

To see the OG configuration options, click on the Administer | Organic group | 
Organic groups configuration link, or navigate to a d mi n / o g / o g. As shown in the 
following screenshot, and as described earlier in this chapter, you have three options, 
each contained in a separate fieldset: 

• Content types 

• Group details 

• Email settings 



Content Types 

The Content types admin section provides an overview of the content types used 
on the site, and how they can be used in relation to groups. The functionality on this 
page overlaps with the Organic groups usage settings exposed provided on the Edit 
page for each content type. 


[ 259 ] 


[packtI 

L PUBLISHING J 


This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 














Supporting Multiple Classes 


When we created the Class and Club group nodes, we examined the options within 
the Organic groups fieldset, as shown in the screenshot under The Organic Groups 
Fieldset section. The Content types fieldset links to the edit pages of content types; 
the same edit pages are accessible via the Administer | Content management | 
Content types link, or by navigating to ad mi n/content/types. 

As we discussed earlier, content within a site using OG can fall into one of three 
categories: usable within a group, not used within a group, or used to create a group. 
Currently, we have two content types — Club and Class — that are used to create 
groups. However, we do not have any content types that we can use in these groups; 
this is the online equivalent of a day of silence. 

To allow people to talk within groups, we need to enable some content types for use 
within groups. 

To do this, click the edit link—visible in the following screenshot —for the content 
type you'd like to edit. Then, navigate down to the Organic groups fieldset. As 
described above, and shown in the screenshot under 77ze Organic Groups Fieldset 
section, we have four options for use within a group. These options are 
paraphrased here: 

• Standard post 

• Standard post with email notification to all group members when the post 
is created 

• Wiki-like post; any member can edit 

• Wiki-like post, with email notification to all group members when the post is 
created 
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As can be seen in the preceding screenshot, the way content types relate to groups is 
displayed on this page. 

In our example, the Class and Club content types (identified by Item 1 in the 
preceding screenshot) are used to create groups. Page and Story nodes (identified 
by Item 2 in the preceding screenshot) are separate from Organic groups, as they 
cannot be posted into any group. The Audio, Image, Video, and Wiki content types 
(identified by Item 3 in the preceding screenshot) are all permitted for use in groups. 

To change the settings for any of these content types, click the edit link. 

Group Details 

The Group details admin section lets us set options that determine how users can 
find groups, and post content into groups. 


Group details 

Groups directory control: 

O New groups don't appear in the groups directory. Administrators control the directory exclusively. 

O New groups always appear in the groups directory. 

® Group creator chooses whether her group appears in the directory. Defaults to in directory. 

O Group creator chooses whether her group appears in the directory. Defaults to notin directory. 

OG admins always see the checkbox for adding a group to the groups directory. Note that changing this setting has no effect on 
existing posts. Re-save those posts to acquire this new setting. 

Registration form control: 

® New groups don't appear on the registration form. Administrators control the form exclusively. 

O New groups always appear on the registration form. 

O Group creator chooses whether her group appears on the registration form. Defaults to on form. 

O Group creator chooses whether her group appears on the registration form. Defaults to noton form. 

OG admins always see the checkbox for adding a group to the registration Form. Note that changing this setting has no effect on 
existing posts. Re-save those posts to acquire this new setting. 

Group email notifications: 

® New members are not subscribed to group email notifications by default. A member may choose to enable 
this from her profile page or her "My membership" page. 

O New members are subscribed to group email notifications by default. A member may choose to disable this 
from her profile page. 

Should new members automatically be notified via email when new content is posted to their group? Note that changing this 
setting has no effect on existing members. 

0 Audience checkboxes 

Show each group that the user is a member of as a checkbox in the "Audience" section. This enables the member to place her 
post into multiple groups. If unchecked, simplify the user interface by omitting the checkboxes and assuming user wants to 
post into the current group. This simplification only applies to new nodes, and not to edits of existing nodes. Group 
administrators always see checkboxes. 

Audience required: 

® Optional 
O Required 

Do you require that all (non administrator) posts be affiliated with a group? Note that changing this setting will affect existing 
posts when they are edited. 
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Groups Directory Control 

The settings in this section define the default value for whether or not newly-created 
groups appear in the group directory. This directory is automatically created when 
OG is installed. The directory is discussed earlier in this chapter in the Useful Links for 
Organic Groups section. 

Registration Form Control 

The Registration form control section sets the default value for whether or not the 
new site members will be given the option to join a group when they are joining 
the site. If you have multiple groups, listing them on the registration form can be 
overwhelming for end users. 

Group Email Notifications 

The settings in this section allow you to determine whether or not members to a 
group are automatically subscribed to emails when new content is published. When 
setting this value, remember that emails will only be sent when they have been 
enabled for specific content types, as described earlier in this chapter, and as shown 
in the screenshot under Tlte Organic Groups Fieldset and Content Types section. 

The Notifications framework at http: II dr u p a I , org/proj e c t / 
noti fi cati ons provides more fine-grained control over the standard 
OG notifications system 

Audience Checkboxes 

Deselecting this option simplifies the process of creating content within a group. 
Selecting this option allows your users to place posts into multiple groups. As a 
general rule, leaving this box unselected creates a site that is easier for novice users; 
selecting this checkbox gives your users more flexibility, but adds a small amount 
of complexity. If you are unsure of what works best for your users, leave this 
box unchecked. 

Audience Required 

As shown in the screenshot under The Organic Groups Fieldset and Content Types, 
content types are allowed for use within groups. Requiring an audience for these 
content types (by selecting Required under Audience required) means that all 
content (of a type that can be posted into a group) must be posted into at least one 
group. Although these posts can also be public, they will appear as part of the 
group content. If an audience is not required (Optional is selected under Audience 
required), then a post can optionally be used inside a group, or can be posted 
entirely separate from any group. 
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Requiring an audience is often easier for new users, as it streamlines the process of 
creating new group content. 

Email Settings 

The various options in the Email settings section allow you to customize the 
notification messages sent on various events, such as when new content is added. 

Remember: Save Your Settings! 

The Organic groups configuration page contains a large number of options. 
Remember that you need to save your changes by clicking the Save configuration 
button at the bottom of the page. 

Setting Organic Groups Access Configuration 
Options 

The second set of Organic Groups options are the Access configuration options. To 
set the Organic Groups Access configuration options, click on the Administer | 
Organic groups | Organic groups access configuration link, or navigate to a d mi n / 

o g/ogaccess. 


Home > Administer > Organic groups 


Organic Groups Access configuration 

Visibility of posts: 

O Visible only within the targeted groups 
O Visible within the targeted groups and on other pages 

O Visibility chosen by author/editor using a checkbox on the posting form. Checkbox defaults to Public. 

® Visibility chosen by author/editor using a checkbox on the posting form. Checkbox defaults to Private. 

Determine how broadly available a given post should be when it is affiliated with a group. OG admins always see the 
checkbox for making a post Public. Note that changing this setting has no effect on existing posts. Re-save those posts to 
acquire this new setting. If the setting you want is disabled here, check the settings under Private Groups setting below. You 
cannot set node visibility to always be public if private groups are set to always on and vice versa. 

Private Groups: 

O New group home pages and default audience are always public. 

O New group home pages and default audience are always private. 

O Group administrator chooses whether her group homepage and audience are private or not 
private. 

® Group administrator chooses whether her group homepage and audience are private or not 
public. 

A private group's group home page cannot be seen by non-members, and new posts created in the group will default to 
being private. This setting controls what private groups options can be used when creating a new group or editing an 
existing group. If you select one of the group administrator chooses options then it will be up to group admins whether their 
new groups are private or not, with the default you specify here. 

Note that the privacy of all content in the group is determined as each node is created or edited, according to the Node 
authoring form / Visibility of Posts setting on this page. Note also that changing this setting only affects the default for new 
groups being created, not the privacy of any existing groups! To change those you must edit the groups and their individual 
content nodes directly. If the setting you want is disabled here, check Visibility of Posts above. You cannot choose to only 
have private groups if node visibility is set to be always public, and vice versa. 


. Defaults to 

. Defaults to 


[ Save configuration ] [ Reset to defaults - ] 
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As seen in the preceding screenshot, this screen has two sections: Visibility of posts 
and Private Groups. 

Visibility of Posts 

The options in this section determine whether a post will be public or private by 
default, and whether or not people can override that default. 

Setting this to the last option— Visibility chosen by author/editor using a checkbox 
on the posting form. Checkbox defaults to Private — provides a good balance 
between privacy and flexibility. 

Private Groups 

This section lets you designate whether or not groups can be made private. Private 
groups offer two levels of privacy: firstly, content within the group is generally not 
visible to non-group members; and secondly, the group homepage can only be seen 
by members of the group. 

For Public groups, non-group members can see the group homepage. 

However, content within public groups can still be set as being off-limits from 
non-group members. 

When you have finished adjusting these settings, save them by clicking the Save 
configuration button. 

Creating and Using Groups 

Now that we have set the default options for the content types that can be used in 
groups and the privacy levels of groups, we are prepared to create the groups. 

Creating a Group 

To create a group, click on the link created when you created the content type. If 
you created the custom menu as shown in the second screenshot under the Create 
a Menu for Groups, you will simply need to click the link for Class. If you did not 
create this custom menu, then the link will be available in the Create content 
menu as shown in the first screenshot under Create a Menu for Groups (refer to page 
number 258). In all cases, regardless of whether you have created a custom menu or 
not, you can create groups by navigating tonode / add / [group-type] . 
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• Title: The group title will be seen frequently throughout the site; a 
good title is short, and descriptive enough to give an idea of the purpose 
of the group. In the case of courses as groups, if you have multiple 
sections of the same course, the title should help differentiate between 
the various sections. 

• Description: The description will show up in the group directory. 
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• Mission Statement: The mission statement shows up on the group's 
homepage. A mission statement can describe the group, and/or contain 
links to a syllabus, course expectations, or other important information. 

• Membership requests: These settings allow you to control how people 
will be able to join your group. 

• Registration form: These settings allow you to control if users can join 
this group when registering for the site. This option can be removed from 
the form entirely; for more information refer to Group Details earlier in 
this chapter. 

• List in groups directory: These settings allow you to control whether or 
not your group is automatically listed, along with other groups on the 
site in the group directory. This option can be removed from the form 
entirely; for more information refer to Group Details earlier in this chapter. 

• Private group: This setting allows you to make your group homepage 
public or private. This setting is also discussed earlier in this chapter in 
Setting Organic Groups Access Configuration. 

Once you have set up your group, click the Submit button to create your group. 

Enabling Group-specific Blocks 

The OG module, in conjunction with the OG Views integration module, creates 
several OG-specific blocks. These blocks are only displayed when viewing groups or 
content posted into groups. 

To see these blocks, click on the Administer | Site building | Blocks link, or 
navigate toadmin/build/block. 


4* 

Group admins 

|<none> 

Al 

configure 

* 

Group categories \ 

|<none> 

iYj| 

configure 
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Group details 2 

|<none> 

V,| 

configure 

4* 

Group files 

|<none> 

v| 
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4* 

Group members 

|<none> 

'Yl 

configure 

4* 

Group notifications ^ 

|<none> 


configure 

4* 

Group notifications (views enhanced) 

|<none> 

m 

configure 


The best way to get a sense of what blocks you should enable is by experimentation. 
To begin, enable the Group categories. Group details, and either of the Group 
notifications blocks. 
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Adding Users/Managing Subscriptions 

Once you have enabled the group-specific blocks, navigate to your new group. 


Home > Groups 


Algebra II Edit Categories E-mai 1 

Algebra II 



Create Assignment 


The mission statement should give an overview of the course goals, and can 
contain links to a syllabus, pictures, and other goodies. 

Create Blog post 

Create Bookmark 

Create Video 


Invite friend 

Read Chapter 1 

Tue, 21/10/2008 - 11:38pm — sally 

Due Date* Algebra polynomials Reading 



Manager: sally 

My membership 


10/22/2008 12:45pm 

Read Chapter 1, in all its glory. 

Add new comment 

Group categories 
Assignment type 

Reading (1) 



The email tab, marked in the preceding screenshot as Item 1, allows group managers 
to email all group members. To add users to the group, click the members link 
as shown in the preceding screenshot as marked by Item 2. This brings us to the 
Members page. Group managers will have links to manage users, while regular 
group members will only see a list of users. 



As identified in the preceding screenshot by Item 1, a user named lucy has requested 
membership. Her membership can be approved or denied by using the links provided. 
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To add members, click the Add members link identified in the preceding screenshot 
by Item 2. 

To add members, list their usernames, and separate each username with a comma. 
When you have entered all of the usernames, click the Submit button to add the 
users to the group. All users to be added must be pre-existing site members. 


Home > Groups 

Members List 

List of users: 


Add members 



Add one or more usernames in order to associate users with this group. Multiple 
usernames should be separated by a comma. 


Submit 


Algebra II 

0 Create Audio 
° Create Image 
0 Create Video 
° Create Wiki 
° Invite friend 
° 1 member (1) 

0 Manager: sally 
° My membership 

Group notifications 

This group offers a RSS feed 


Creating Additional Group Managers 

Once members have been added to a group, the group manager can promote any 
individual member to a group admin role. 

As can be seen in the screenshot of the Members page, indicated by Item 3, additional 
group managers can be created by using the Admin: Create link. 

Group administrators have the same rights as the group manager; if two teachers are 
working together in the same class, both teachers should be group managers. 

Also, a person can be a group manager in one course, and a regular participant in 
another course. This allows, for example, teaching assistants to be given extended 
rights in the group for which they are a TA. 

Adding Group-specific Taxonomies 

Using the Organic groups vocabularies module, we can set up unique vocabularies 
for each group. This allows each group to have separate ways of categorizing 
content. This can be useful for different classes, as an English class will have different 
needs and categories than a Biology class. 
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Group managers and group administrators have the rights to create new 
vocabularies. To create a specific vocabulary for a group, click the Categories tab 
(shown in the preceding screenshot by Item 1). Then, click the link to add vocabulary 
(shown in the preceding screenshot by Item 2). 

From here, the process of creating a vocabulary is identical to creating all other 
vocabularies in the site, as described in Chapter 3. 

For this example, we will create a vocabulary to categorize Assignment nodes. 

• Vocabulary name: Assignment type. 

• Description: Leave blank. The description is only shown to group managers, 
and should be obvious from the context. 

• Help text: Select the appropriate term. 

• Types: As this vocabulary is only for assignments, just select the checkbox 
next to assignment. 

• Settings: Tags. 

• Weight: 0 (the default value of 0 will work, but adjust this setting as needed). 
Click the Submit button to save your vocabulary. 

Once you have created your vocabulary, use the add terms link to populate it 
with specific terms. For the Assignment type vocabulary, the terms should be the 
different types of assignments used in the course. 
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Creating Content in a Group 

For this example, we will create an assignment for the group. 

To create an assignment, click the Create assignment link as shown in the 
following screenshot: 



When you create the assignment, tag it with a term from the Assignments vocabulary. 

In most cases, you will not need to adjust the settings in the Groups section, shown 
in the following screenshot. This section shows the different groups to which you 
belong, and, if you have the permissions, this section also gives you the option to 
make a post visible to non-group members. 
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Click the Submit button to create your assignment. 

Once you have saved your post, you will see it appear on the group's home page. 
Additionally, if you have tagged it with a group-specific category, you will see this in 
the Group categories block as shown in the following screenshot: 



Summary 

Using groups allows you to support classes, clubs, extracurricular activities, study 
groups, and other activities. Moreover, different groups can be used to support 
different types of learning. 

The Organic Groups module provides you with a range of options for configuring 
groups. The best options for your site will likely vary widely based on teacher and 
student preference. For example, some teachers might want to use private groups, 
whereas others will want more public interactions. With this in mind, the optimal 
group settings—finding the balance between group privacy, user privacy, free 
interactions, connections between groups, and so on—will evolve over time as 
people work in the site and begin to understand how to use the different features. 
So, while you may get it right the first time, don't count on it. Fine-tuning group 
configurations requires talking with and listening to people using your site. 
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Finally, effective group use also requires some training for group managers to help 
them understand the different options they have available to them. Periodic training 
also provides the opportunity for people to provide feedback about the different 
features of the site. Groups play a central role in the growing community around 
a site; fine-tuning the technical aspects of how they work should be seen as both a 
technical and community-building exercise. 
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Tracking Student Progress 

As more people post more content into your site, you will need some simple ways 
to keep track of their work. This chapter outlines some techniques for organizing 
student work to allow you to effectively monitor student progress and learning. 


Getting an Overview of Student Work 

Drupal offers several methods of tracking student work. The simplest method, and 
one that will work very well for sites with a small number of members, uses the core 
Tracker module. For sites with larger numbers of users, and more complex tracking 
needs, we can use the Views module. We will discuss various methods of using the 
Views module later in this chapter. 

Using the Core Tracker Module 

To start, make sure that the Tracker module is enabled. Click on the Administer | 
Site building | Modules link, or navigate to a d mi n / b u i I d / mo d u I e s . In the Core 
- optional section, make sure that the Tracker module is enabled. 
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The Tracker module tracks the posts of all users. To see a list of all content created on 
the site, click the Recent posts link—which is generated by the Tracker module —in 
the main navigation menu, or navigate to http://yoursite.org/tracker. While 
this is a useful way to see a quick list of recently created content, it isn't the most 
useful way of tracking posts from large numbers of users. 



The core Tracker module also tracks the posts of individual users. To see these 
individual user pages, navigate to a user's profile page (usually by clicking on their 
username), and click the Track tab. 
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However, this quickly becomes tedious, particularly if you are working with 
many students. 

Replacing the Tracker Module with Views 

The core Tracker module, while useful in a general sense, can feel insufficient 
in sites with large numbers of students, and in sites using groups to support 
multiple classes. 

To use Views instead of the core Tracker module, you need to do two things. First, 
disable the Tracker module by clicking on Administer | Site building | Modules 

link, or by navigating to a d mi n / b u i I d / mo d u I e s. 

Second, you need to enable the tracker view that ships with the Views module. To 
enable this view, click on the Administer | Site building | Views link, or navigate 
to ad mi n / b u i I d / vi e ws. 



Click the Enable link to activate the view. 


The tracker view that ships with the Views module replicates the functionality of 
the core Tracker module, and is visible at the same URL: http://yoursite.org/ 
tracker. The main difference is that the Views-based solution removes the Track tab 
on the user profile page, as shown in the screenshot before the preceding one. 

A reasonable person might ask why we use the Views module to deliver functionality 
when the Tracker module does exactly the same thing. Using the Views module 
allows us to modify the fields returned in our view; for example, the core Tracker 
does not show any taxonomy terms connected to a post. Using the Views module, we 
can modify the default view that is provided to display all taxonomy terms. 



For a detailed overview of adding new views, refer to Chapter 3. For a 
detailed overview of modifying a view that ships with the Views module, 
refer to Chapter 4. 


] 
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The Views module also allows us to filter the results in ways that are not possible 
using the core tracker module. Later in this chapter, we will highlight techniques and 
strategies for building flexible solutions using views. 

Using Code Snippets to Track Student 
Progress 

Code snippets are small chunks of PHP code that can be embedded in a page. 

Using PHP snippets offers a great deal of flexibility, but they should also be used 
with extreme care. To start, the right to embed PHP snippets should only be given 
to trusted users who actually know PHP. A poorly-formed PHP snippet has the 
potential to bring down a site; a malicious user with the rights to use PHP snippets 
can also wreak havoc. However, when used appropriately, PHP snippets are a 
powerful tool. 

Enabling PHP Snippets 

To enable selected users to embed PHP snippets, we first need to enable the 
PHP filter module. To enable this module, click the Administer | Site building | 
Modules link, or navigate to a d mi n / b u i I d / mo d u I e s . In the Core - optional 
section, enable the PHP filter module. Click the Save configuration button to save 
the changes. 

Then, click the Administer | Site configuration | Input formats link, or navigate to 
ad mi n/setti ngs/fi I ters. 

[C Configuring Input formats are also discussed in Chapter 4. 

Click the Configure link for the PHP code input filter; this brings you to the admin 
screen shown in the following screenshot: 
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As mentioned earlier in this section, access to the PHP input format should only 
be given to highly-trusted users. As seen in the preceding screenshot, we are only 
giving users with the site admin role the rights to use this input format. 
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Embedding a PHP Snippet in a Page 

For users with the rights to use the PHP input format, code snippets can be 
embedded in any post. 

The following code snippet gives a listing of all students in the site, with links to each 
user's tracker page. This snippet assumes that you have created a Last name field in 
the user profile, as described in Chapter 11. 

When an anonymous user views the page, they are directed to log in. When users 
who do not belong to the teacher role view the page, they are presented with a link 
to their profile. When users in the teacher role view the page, they are presented 
with a list of all users in the student role, sorted by last name, with a link to their 
tracker page. 

For this example, we will embed the PHP snippet in a page. To create the page, click 
the Create content | Page link, or navigate to node/add/page. Type the snippet into 
the Body, and DO NOT use the text editor, as the editor will strip out the PHP code. 

<? php 

global $ u s e r; 

$i nstructor_role_i d = 3; 

If ($user->uid == 0) { 

print I (t ( 1 Y o u must log in to view this page 1 ), ’user 1 ); 
return; 

} 

else if (!array_key_exi sts($i nstructor_rol e_i d, $ user->roI es)) { 
print l(t('View your profile'), 'user/'. $user->uid); 
return; 

} 

$ i t e ms = array!); 

$per_page = 50; 

$profi I e_fi el d_i d = 1; // last name profile field id 
$student_rol e_id = 4; 

$ r e s u I t = pager_query( "SELECT u.uid, u.name, pv.value FROM {users} 
u JOIN {us e r s _ r o I e s} ur ON u.uid = ur.uid JOIN 
{profi I e_val ues} pv ON u.uid = pv.uid WHERE pv.fid = %d 
AND ur.rid = %d ORDER BY pv.value, u.name", $per_page, 0, 
NULL, $profile_field_id, $student_rol e_i d) ; 
while ($account = db_fetch_obj ect($result)) { 

$ i t e ms [ ] = I ( $account - >name, 'tracker/'. $account - >ui d) .' | 

$ a cc o unt->vaI ue; 

} 

$ o u t put = ' <di v cl a s s =" user-I i st" >' ; 

$ o u t put .= t h e me ( ' i t e m_ I i s t' , $ i t e ms) ; 

$ o u t put . = ' </ d i v >' ; 

$ o u t put .= the me ('pager', array!), $per_page); 
print $ o u t put 

?> 
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Create Page 


|[ist of site l 


- D Menu settings 


Body: 


0 Show summary in full view [ Split summary at cursor ~] 


<?php 

global $user; 

$instructor_role_id = 3; 
if ($user->uid == 0) { 

print l(t(You must log in to view this page'), 'user 1 ); 
return; 

> 

else if (!array_key_exists($instructor_role_id, $user->roles)) { 
print l(t('View your profile 1 ), 'user/ 1 . $user->uid); 
return; 

> 

$items = arrayO; 

$per_page = 50; 

$profile_field_id = 1; // last name profile field id 
$student_role_id = 4; 

$result = pager_query("SELECT u.uid, u.name, pv.value FROM {users} u JOIN {users_roles} ur ON u.uid = 
ur.uid JOIN {profile_values> pv ON u.uid = pv.uid WHERE pv.fid = %d AND ur.rid = %d ORDER BY pv.value, 
u.name", $per_page, 0, NULL, $profile_field_id, $student_role_id); 

while ($account = db_fetch_object($result)) { $items[] = l($account->name, 'user/'. $account->uid 
.'/track').' | '. $account->value; } 

$output = '<div dass="user-Iist">’; 


Switch to rich text editor 

The ID for excluding or including this element is: edit-body - the path is: node/add/page 
- Input format 


O Filtered HTML 

O Web page addresses and e-mail addresses turn into links automatically. 

O Allowed HTML tags: <a> <b> <blockquote> <br> <caption> <center> <code> <col> <colgroup> <dd> <del> <div> <dl> <dt> <em> <font> 
<hl> <H2> <h3> <h4> <h5> <h6> <hr> <i> <img> <li> <ol> <p> <span> <strong> <sub> <sup> <table> <tbody> <td> <tfoot> <th> 
<thead> <tr> <u> <ul> <tr > 

O Lines and paragraphs break automatically. 

O Full HTML 

O Web page addresses and e-mail addresses turn into links automatically. 

O Lines and paragraphs break automatically. 

® PHP code 

O You may post PHP code. You should include <?php ?> tags. 


More information about formatting options 


* 


| Save | [ PreviewH 


When saving a post with an embedded code snippet, ALWAYS use the 
Preview button. This way, if there are any issues with your snippet, you 
will discover them on preview, before any PHP errors do any damage. 

When you are done entering the PHP snippet, select PHP code as the Input format. 
Then click the Preview button to ensure that your snippet works as intended. Once 
you have ascertained that your snippet works as you need, click the Submit button 
to save the node. 



[ 279 ] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 























Tracking Student Progress 


Once the page has been saved, you will see a page as shown in the 
following screenshot: 



The username links to the user's profile page. The snippet displays a person's 
username, followed by their last name. 

Explaining the Snippet 

• The Last name field has a field id, or f i d , of 1 — controllable with the 

$profi I e_fi el d_i d variable. To figure out the f i d for your different profile 
fields, click the Administer | User management | Profiles link, or navigate 
toadmi n/user/profi le. As shown in the following screenshot, if you move 
your mouse over the edit link for the profile fields, the f i d will show in the 
bottom left corner of your browser. 



• 50 users per page — controllable with the $ p e r _ p a g e variable. 
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• The Teacher role id is 3—controllable with the $ i nstructorrol e_i d 
variable; and the Student role id is 4—controllable with the $st udent_ 
r o I e i d variable. To figure out the role ids for your different roles, click the 
Administer | User management | Roles link, or navigate to a d mi n / u s e r / 
r o I e s. As shown in the following screenshot, when you move your mouse 
over the edit role link, the role id appears at the end of the URL in the 
bottom left corner of the page. 



Although PHP code can be embedded in any node, it is a very powerful, and 
therefore very dangerous tool. As discussed earlier, you should exercise very careful 
control over who can access the PHP input format, through the administrative 
controls via the Administer | Site configuration | Input Formats link, or by 
navigating to a d mi n / s e 11 i n g s / f i I t e r s . 

Using Views and PHP Snippets Together 

Individually, both views and PHP snippets let us do some amazing things; when 
used together, we have even more options. In this section, we will cover one 
technique that uses a snippet to pass arguments to a view. This technique can be 
adapted to different contexts to provide some very powerful methods of creating 
dynamic navigation paths through content. 

This can be very useful when tracking posts in a site that uses Organic Groups. In 
our example, we will create a view that takes two arguments: the group id and the 
user id. These two arguments will allow us to display all of the posts created by a 
specific user in a specific group. 
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Our PHP snippet will display a list of groups to which the currently-logged in 
user belongs. The membership of each group will also be listed, and clicking on a 
username will pass the arguments — the group id and the user id— to the view. 


Creating the View 

To create this view, we will clone the Node view: tracker view that ships with the 
Views module. We enabled this view earlier in this chapter. 

[C Cloning views is covered in detail in Chapter 4 and Chapter 6. 

To clone the view, click the Administer | Site building | Views link, or navigate to 
admin/bui I d/views. Click the Clone link for the Node view: tracker view. 

This brings us to the Clone view admin screen, where we need to enter the 
following values: 

• View name: byuser_bygroup 

• View description: Shows all posts in a group by an individual user 

• View tag: track_content (tags are optional; this field can be left blank) 

After entering values for these fields, click the Next button to proceed. To complete 
cloning the view, we will need to edit some values in the Defaults display and the 
Page display. 

Adjusting the Defaults Display 

In the Defaults display, we will need to add Fields, and also add an Argument. 
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This screenshot shows the view after the edits described in this section have 
been completed. 

To add Fields, click the + icon as indicated in the preceding screenshot by Item 1. To 
add Arguments, click the + icon as indicated in the preceding screenshot by Item 2. 

Adding Fields 

Add the Organic Groups: Group field, and the Taxonomy: All terms field. 

After configuring the fields, click the Update button to save the changes. 
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Adding an Argument 

Add the Organic groups: Groups argument. Once we have added the argument, we 
need to configure it to refine its behavior. 



The only option we need to change here is the Title. Enter Posts in %2 by %1. This 
title contains two placeholders — %1 and %2 — that will pull their values from the 
arguments. As marked by Item 2 in the screenshot prior to this one, this view is 
configured to take two arguments; the first (%1) for a user id, and the second (%2) for 
a group id. When this title is created, it will substitute the username for %1 and the 
group name for %2. 

Click the Update button to save the argument configuration, then click the Save 
button to save these edits. Now, we can move on to adjusting the Page display. 
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Adjusting the Page Display 

In the Page display, we will need to change the Path and delete the menu item. Both 
of these settings are controlled in the Page settings section. 

For this example, we will set the path to b y g r o u p. 

Click the Save button to save the view. 


Embedding the Snippet 

The view that we created, visible at http://examp le.edu/bygroup, takes two 
arguments: one for user id, and the second for the group id. To make this work 
manually, we would need to know the numerical id of both users and groups. To 
state the obvious, this is less than useful. However, a code snippet can create these 
links for us, and present them to us in a usable format. 

On a class site using Organic groups, teachers and students will likely belong to 
multiple groups. Teachers, in particular, will want to be able to take a look at the 
work completed by individual students within their groups. The following PHP 
snippet lists the groups that a user belongs to, and lists all of the users within those 
groups. Then, it creates a link off the username that feeds the user id and the group 
id to the view created above. 


Embed the snippet in a page by clicking the Create content | Page link, or by 
navigating to node/add/page. 

<? php 

drupal _add_j s( 1 mi sc/col I apse.j s'); 

$ o u t put = ''; 

function _my_group_sni ppet_pri nt_groups($headi ng, $gi ds) { 
global $ u s e r; 

If ( empt y( $ g i ds) ) { 
return: 

} 

$s epa rat or = 1 | 1 ; 

$ o u t put = ' <h 2 >' . $ h e a d i n g , 
foreach ($gi ds as $gi d) { 

$ g r o u p = $user->og_groups[ 


</ h2 >' 


;gi d] 


$ 0 u t put 


<fl el dset cl ass ="col I apsi bl e" ><l egend>' 


$ g r o u p [ 1 t i 11 e 1 ] . 1 </ I e ge nd >' ; 

II get all users in group $ g i d 
$ Ii n k s = a r r ay(); 

$ r e s uI t = db_query(og_li st_users_sql( ), $ gi d) 
while ($ u = db_fetch_obj ect($resul t)) { 
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$1 oaded_user = user_I oad(array( 1 ui d 1 => $u->ui d)); 

$ Ii n k s[] = I ($1 oaded_user - >name, 'bygroup/'. $1 oaded_user->ui d 
$ gi d) . $separator . $1 oaded_user->profi I e_l ast_name; 

} 

$ o u t put . = t h e me ( ' i t e m_ I i s t' , $ I i n k s) ; 

$o ut put .= ' </ f i eI ds et >' ; 

} 

print $ o u t put; 

} 

gl obal $us er; 

foreach ($user->og_groups as $ gi d => $ g r o u p) { 
if ($group['is_admin']) { 

$admi n_groups[ ] = $gi d; 

} 

el se { 

$ o ther_groups[] = $ g i d; 

} 

} 

_my_group_sni ppet_pri nt_groups(t(' Groups I manage'), $admi n_groups) ; 
_my_group_sni ppet_pri nt_groups(t(' My groups'), $other_groups) ; 

?> 

Once you have entered the snippet into the page and tested it by using the Preview 
button, create the page by clicking the Save button. 

Explaining the Snippet 

This snippet starts by getting the user id of the user viewing the page. It uses this 
user id to generate a list of groups to which the user belongs, and then uses the 
group ids to get a list of users within each group. 

A closer examination of a section of the snippet helps show how this snippet works. 

$1 oaded_user = user_I oad(array(' ui d' => $u->ui d)); 

$ Ii n k s[] = I ( $ I oaded_user - >name, 'bygroup/'. $1 oaded_user->ui d 
$ gi d) . $separator . $1 oadeduser - >profi I e_l astname; 

This section of the snippet helps generate the output that creates the links to the 
view, and displays the last name from the user profile: 

• bygroup is the identical path that we set to the view; if you have used a 
different path when creating your view then you will need to adjust this 
section of the snippet. 

• profile_last_name is the field name of the custom profile field we created in 
Chapter 11. To use a different field, adjust this name accordingly. 
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Groups overview 
Groups I manage 

, c Documentary Film Production 

° camille | Claudel 
° frida | Kahlo 
° hambone | LeGree 
° helen | Garcia 
I ° jeremiah | Wright 
° lucy | Orestes 
° sally | TestAdmin 
° william | Ayers 

My groups 

■> Algebra II 
O British Literature 


D> Geometry 


The actual groups, and members within those groups, will obviously vary 
depending upon the user viewing the page. 

Clicking on a username brings you to the view, as shown in the following screenshot: 
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In the preceding screenshot, the title of the view — Posts in Documentary Film 
Production by jeremiah —is pulled from the arguments we set up earlier in this 
section when we modified the tracker view. And, because we are using the Organic 
groups: Groups argument, we are effectively dropping ourselves back into our 
group; this is why we have the group blocks appearing in the right-hand sidebar. 

Tracking Responses to Specific 
Assignments 

In some cases, an assignment will be answered by students online. This section 
covers how to track student responses to specific assignments. In Chapter 6, we 
cloned the default backlinks view that comes with the Views module as a way of 
showing links between blog posts. We will use the same technique to see student 
responses to specific assignments. 

Chapter 6 describes the steps we need to follow. Depending on how you want your 
view to look, you can add fields, modify the display style, and experiment with other 
options as described in the different sections of this book. However, the primary 
changes we need to make with this view concern modifying the argument and the 
access to the view. 

All of the edits we will make will be to the Defaults display. 

Editing the Argument 

We only want this view to return posts that link to assignments. To make this 
happen, we need to edit the existing argument of the view to only validate 
for assignments. 
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As shown in the preceding screenshot by Item 1, click the Search: Links to link. This 
brings up the configuration options shown in the bottom section of the screenshot. 
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Then, as indicated by Item 2, change the Title to: Posts responding to %1. 

Lastly, as indicated by Item 3, select Assignments as the node type. 

Click the Update button to save these changes. 

Restrict Access 

Views provide you with several options for restricting access. As this view collects 
student responses to work, we will limit access to it by only allowing users with the 
rights to create assignments to see it. 



As shown in the preceding screenshot by Item 2, click the access content link. This 
brings up the Defaults: Access restrictions options. Select Permission as indicated 
by Item 2, and then click the Update button. 


Defaults: Access options 
Permission: 

[ create assignment content i v] 

Only users with the selected permission flag will be able to access this display. Note that users with "access all views" can 
see any view, regardless of other permissions. 


[ Update ] | Cancel ] 
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From the Permission drop-down menu, select create assignment content. Selecting 
this option means that any user with the rights to create assignments can see 
the view. 

Click the Update button to save the changes, and the Save button to save the view. 


How it Works 

When a student is responding to an assignment, they need to include a link to the 
assignment in their response. By including the link to the assignment, the site will 
automatically detect the backlink, and register it as a response. 


[ 



As described in Chapter 6, the list of backlinks is created during cron 
runs. For information on setting up cron, refer to Chapter 15: Backup, 
Maintenance, and Upgrades. 


] 



In the preceding screenshot, we can see the response page. In addition to the edits 
described in this chapter, this view contains some additional fields, including the 
created on date, the username (that is, the person responding to the assignment), 
and a user picture. Adding fields to views is covered in Chapters 3, 4, and 6. 


Private Communication with Students 

Throughout a course, teachers may want to keep private notes on students' progress, 
or create an online space where they can communicate directly with students 
regarding their progress. By using the Coherent Access module, teachers and 
students can create posts, and then single out individual users who can see 
and/or edit these posts. Additionally, posts can also be private, in which case they 
are only visible to the author, making this method suitable for maintaining a journal 
or private notebook. 
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Getting Started 

Download the Coherent Access module from http://drupal . org/proj e c t / 
coherentaccess. Install this module as described in Chapter 3. 

Then, click the Administer | Content management | Content types link, or navigate 
to ad mi n/content/types. Create a content type named Notes, and in the Workflow 
settings, make sure you enable Create new revisions as the Default option. 

Next, click the Administer | User management | Roles link, or navigate to a d mi n / 
u s e r / r o I e s . Assign rights to the Notes content type: both the Teacher and Student 
roles should be able to create notes and edit own notes. 

Configuring Coherent Access 

Click the Administer | Site Configuration | Coherent access link, or navigate to 
ad mi n/setti ngs/coherent-access. 


Home > Administer > Site configuration 


Coherent Access 

Node types that are allowed to use coherent access.: 

Group 1 

Page 

Story 

2 0 If checked new nodes will default to private. 

3 0 Send email when viewers or editors are added 

Email notification subject: 

You have been added as a %role for %nodetitle by %sender 

4 


Email notification body: 

You have been added as a %role for %npdetitie by %sender. You can access this by going to %npdeurl 

5 


[ Save configuration"! [ Reset to defaults"] 
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As pictured in the preceding screenshot by Item 1, you can specify which content 
types should have access governed by Coherent Access. In this case, we just want to 
use this for Notes. 

Next, as indicated by Item 2, we can set the default to private or public. In this 
example, as we are using this to store information about students, we want this set 
to private. 

The settings indicated by Item 3 allows us to specify whether we want emails sent to 
all viewers or editors as they are added, and Item 4 and Item 5 allow us to customize 
the email. 

When the settings are complete, click the Save configuration button to save them. 



The Coherent Access module (as the name implies) is an access control 
module. In Drupal 6 and its earlier versions, using multiple types of 
access control on the same piece of content can result in behavior that 
looks unpredictable to the end users. To prevent this, any content type 
that is governed by Coherent Access should not be used inside an OG, 
as this is also an access control module. The good news? There is ongoing 
work to resolve this in Drupal 7. For those interested in the gory details, 
refer tohttp://drupal . org / node / 196922,htt p: / / drupal . o r g / 
node/305566, and http://drupal.org/node/309007. 
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Using Coherent Access 

To use coherent access, create a Note by clicking the Create content | Note link, or 
by navigating to node/add/note. The Coherent Access module adds a set of privacy 
options inside a Shared Editing fieldset. These settings can be adjusted when the 
Note is created. 



To add editors and viewers, type the username into the Add editor or Add viewer 
field, and click the appropriate Add button. The username fields will autocomplete 
as names are added. 

Then, after you have added all desired viewers or editors, save the node. Note that if 
a node is marked private, and no viewers or editors are added, the post will function 
like a private journal. 
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Tracking Posts Created and Shared Using 
Coherent Access 

All private posts are displayed on your user profile page. As shown in the following 
screenshot, the Coherent Access module adds a tab to the profile. 



The posts are separated into three different categories: Posts you have created, posts 
you can edit, and posts you can view. 

Summary 

The techniques described in this chapter provide several methods for keeping 
track of student work, and for providing feedback on that work. Over time, as you 
experiment with different options, you will find the method that aligns cleanly 
with your teaching and web browsing style. As you build different methods of 
tracking student work, it's okay to have two or more pages offering similar content. 
Experimenting with different options accomplishes two important things: first, it 
allows you to experience different methods of working within the site; and second, 
the process of experimenting gets you more familiar with the tools at your disposal. 
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Theming and User 
Interface Design 

In this chapter, we will examine how to make your site easier to use, and how to 
customize its look and feel. 

Discussions of design can get tricky. If you ask 10 people to define what they mean 
by design, you run the very real risk of getting a dozen answers. 

To simplify and focus the conversation, we will concentrate on a subset of 
design elements: 

• Navigational and menu structure, including setting a home page 

• General design elements (for example, the logo, text color, background colors 
or graphics, and so on) 

By focusing on these elements, we will seek to maximize the effect of time spent 
designing your site. When working on site design, we need to remember that the 
point of design is to make things easier and more enjoyable for people using 
your site. 

Basic Principles 

Two basic principles will guide our design work: make things as simple as possible 
by hiding unnecessary options. 
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Keep it as Simple as Possible 

If you look at the Google homepage at http:/ /google, com you don't see much. 

And that's precisely the point. You're not presented with a huge number of options 
because the people designing that page have made some decisions about why people 
are navigating to http:/ /google, com — they have arrived there to search. The screen 
is remarkably uncluttered. Nothing gets in the way of what the user is there to do: 
type in a search string, click submit, and then browse away. 

The minimalistic design—with a splash of color in the logo — supports the main 
activity people engage in at Google. 

To look at it in another way, there is nothing on the page to distract or impede the 
user from what they are there to do. 

Which brings us to the second main principle of creating an easily navigated site: 
hide unnecessary options. 

Hide Unnecessary Options 

Frequently, people designing educational portals attempt to create a landing page 
that links to the full range of activities within the site. While creating such a detailed 
and useful landing page is a worthwhile goal, it often results in a page that is 
visually cluttered and text-heavy. For an example of what I describe, navigate to 
virtually any page built within Ning. An example of such a page is shown below. 

The screenshot has been split into two: 
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In order to conserve space, we are only showing the top half of the page. The 
text-heavy layout makes it difficult for users to find content; imagine how a user 
with any spatial processing issues would fare with a page like this. 

By paying attention to how you build your menus and how you organize your site, 
you can avoid this problem. A series of well-organized menus allows you to group 
related options together, and create a site that is intuitive to navigate. By keeping 
your pages as uncluttered as possible, with simple, well organized menus, you will 
create a site that is far easier to use than the site shown above. 

These ease of use issues are particularly important when you are working with 
students learning a language, or with adult language-learners. Additionally, sites with 
uncluttered pages will be easier to use for students with learning difficulties. 

Setting the Home Page 

Create a page that gives an overview of your site. As shown in the following 
screenshot, alias this page in the URL path settings to h o me . 
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Then, click the Administer | Site configuration | Site information link, or navigate 
to a d mi n / s e 11 i n g s / s i t e - i n f o r ma t i o n . As shown in the following screenshot, set 
the Default front page setting to h o me . 
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Click the Save configuration button to save the default front page settings. 

The other items on the Site information page are covered later in this chapter. 

Menus, Blocks, and Primary Links 

Menus and Blocks are the central elements used to build a navigational structure. A 
Menu is a collection of links; Blocks have many uses, but for this discussion we will 
focus on how they are used to display menus. 

At its most basic, designing a navigational structure can be reduced to this 
simple process: 

1. Create a list of places that you want your users to go, and/or of things they 
will need to do. For example, you want your students to be able to see a list 
of assignments, your blog, and other student blogs; you could place links to 
these pages in a custom menu, which would automatically generate a block. 

2. Then, via the block display settings, show the block. 

Primary and Secondary Links 

Primary links are a unique type of menu in that most Drupal themes are set up 
to format and display them in a specific way. Primary links are usually displayed 
across the top of your site; they are useful for presenting your users with a consistent 
set of links across all pages on the site. 

Primary and Secondary links can be set and configured through the menu settings 
accessible via Administer | Site building | Menu | Settings link, or by navigating 
to ad mi n/bui I d/menu/setti ngs. Secondary links can be connected to primary links, 
or can be set apart as a smaller sub-menu, completely distinct from the primary links. 

In short, primary and secondary links can be used in a variety of different ways, and 
the most effective use of them will be determined by the specific goals of your site. 

If you are looking to extend the functionality of primary and secondary links, you 
should look at the Menu Block module at http: / /drupal . org/proj ect/menu_ 
b I o c k . This module allows you to display nested menus in a block. While primary 
links are excellent for displaying a small number of important links, they are not 
good at showing more than a couple of options below that primary menu. The Menu 
Block module solves that problem. 
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Creating Customized Menus 

As is usually the case with Drupal, you have several viable ways of doing something. 
In this instance, we need to get back to our goal: creating a clean, easy-to-use 
navigation structure. Toward this end, we want to complete the following 
three tasks: 

1. Split the Administration functionality into a separate menu, and display the 
resulting block 

2. Separate the "Create Content" links into a separate menu, and display the 
resulting block 

3. Create the Primary links 

Create a Separate Administration Menu 

The core Drupal navigation menu lumps the site administration options menu 
in with the non-administrative options. For users who have a limited set of 
administrative responsibilities, this can create a large number of options that can be 
confusing to navigate. To reduce screen clutter, we will seek to strip out as many 
unnecessary options as possible. Then, we will organize the remaining menu items in 
a way that makes sense. 

As we add and customize new menus and blocks, we will follow these general steps: 

1. Add a new menu (or use an existing menu) 

2. Enable the block associated with the menu 

3. Add menu items into the menu 

4. Fine-tune the block settings, including the block name and the 
visibility settings 

These four steps will guide us as we create a more intuitive navigational structure. 
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Adding New Menus 

Let's start by adding new menus: 

1. Click the Administer | Site building | Menus link, or navigate to a d mi n / 

b u i I d / me n u. 

2. Click the Add Menu tab. 


Packt and Drupal Open Source Goodness 


Search this site: 


Home > Administer > Site building > Menus 

Menus List menus Settings 


billfitzgerald 


Enter the name for your new menu. Remember to enable the newly created block in the blocks administration 
page. 


° My account 
t> Create content 
° Recent posts 
v Administer 

t> Content management 
v Site building 
° Blocks 


[more help...] 


Menu name: * 

[site-administration [ 

The machine-readable name of this menu. This text will be used for constructing the URL of the menu overview page for this 
menu. This name must contain only lowercase letters, numbers, and hyphens, and must be unique. 

Title: ♦ _ 

|site Administration 


v Menus 

° Navigation 
o Primary links 
° Secondary links 


Description: 

This menu contains all the links to administer your site. By separating these links into a separate menu, 
you create a site that is easier to use.| 


3. On the Add menu form, enter the following values: 

° Menu name: site-administration 
0 Title: Site Administration 

0 Description: This menu contains all the links to administer 
your site. By separating these links into a separate menu, you 
create a site that is easier to use. 

4. Click the Save button to create the menu. 

Whenever you create a new menu, Drupal automatically creates a block 
to display that menu. In order for your new menu to be displayed, you 
need to enable the block. 
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Enabling the Block 

In order to enable the block, we will carry out the following steps: 

1. Once you have created the menu, navigate to the Block administration 
section by clicking the Administer | Site building | Blocks link, or by 
navigating to a d mi n / b u i I d / b I o c k s. 
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Open up the Block menu in a new tab. Because of the close relationship 
between menus and blocks, having both tabs open at the same time 
allows you to switch between them quickly; press the F5 key on your 
keyboard to refresh the screen, and see the effects of any changes. 

2. Enable the Site Administration block by dragging it to the Left 
sidebar region. 




3. Click the Save blocks button to save your changes. 
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4. Examine the Navigation menu in the left sidebar. Nothing has changed! 
What kind of sham is this? 



5. No sham at all. Although we have created the menu and enabled the 
block, the menu currently has nothing to display, therefore the block isn't 
displayed. This order, however, is critical, for reasons explained below. 
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Adding items to the Menu 

For this step, we are moving the existing administrative options into our new menu. 

1. Click the Administer | Site building | Menus link, or navigate to 
ad mi n/bui I d/menu. Click the Navigation link, as pictured in the 
following screenshot: 



2. Scroll down the page until you see the Administer menu item. Click the edit 
link to the right of this item. 



*!* Story 

□ 

0 

edit 

❖ 

Recent posts 

□ 

0 

edit 

* 

Administer 

□ 

0 

lediti'^^™ 


♦F Content management 

□ 

0 

edit 


* 

Comments 

□ 

0 

edit 


* 

Content 

□ 

0 

edit 


❖ 

Content types 

□ 

0 

edit 


* 

Post settings 

□ 

0 

edit 
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3. This opens the Menu settings page, as seen in the following screenshot: 
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4. The only setting we need to change here is the Parent Item. As shown in 
the following screenshot, select the Site Administration option as the 
parent item: 


Parent item: 


<Navigation> _ :(v) 

<Navigation> 

— Blogs (disabled) 

— My blog 

— Compose tips (disabled) 

— My account 

— Search (disabled) 

— Create content 

— Blog entry 

— Page 

— Story 

— Recent posts 

■ — Log out 

■ <Primary links> 

<Secondarv links> _ 


d 

•ji 


it' 


<Site Administration> 


5. Click the Save button. Now you will see the structure of the left sidebar 

change. The Site Administration block we enabled earlier now appears with 
all of the administrative options contained within it. 
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In the above instructions, I referred to the order of these steps as "critical." The reason 
we created a new menu and left it empty, then enabled the empty block, and finally 
filled the menu, has to do with the relationship between menus and blocks. If we 
hadn't enabled the block, we would have effectively caused the administrative menu 
to disappear. 

If that should ever happen to you, don't worry: you can always return to the 
administrative options by navigating to / a d mi n in your site. 

For this example, we do not need to adjust the block visibility settings. 

Create a Separate "Add Content" Block 

Within Drupal usability studies, many respondents point to confusion when it comes 
to adding content within a site. To help reduce this confusion, we will separate out 
the links to add content into a separate block. This step helps distinguish the process 
of adding content from the other possibilities in the site. 

In Chapter 12, we mention another menu customization: separating all the 
content types that can be used to create groups into their own menu. The 
steps used for creating a custom Add Content menu can be used to create 
a custom Create Groups menu. 

Just as when we added the custom site administration block, we will follow these 
four steps: 

1. Add a new menu (or use an existing menu) 

2. Enable the block associated with the menu 

3. Add menu items into the menu 

4. Fine-tune the block settings, including the block name and the 
visibility settings 

Adding New Menus 

Click the Administer | Site building | Menus link, or navigate to a d mi n / b u i 
me n u . As described earlier in this chapter, we will use the Add tab to add two 
menus: Add New Content and Holding Tank. 

As the name implies, we will use the Add New Content block to hold the links for 
adding new posts. 


I d / 
new 
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When creating the Add New Content block, use the following values: 

• Menu name: add-content. 

• Title: Add New Content. 

• Description: This menu contains links for adding content. It replaces the 
default "Add Content" menu. 

We will use the Holding Tank as a place to store links we are not going to use. 
Although we could just disable these menu items, moving them to the Holding Tank 
menu also simplifies the menu administration. 

When creating the Holding Tank block, use the following values: 

• Menu name: holding-tank 

• Title: Holding Tank 

• Description: This menu is a storage tool for links we do not need or want 
to use 

Once the two new menus have been created, we will enable the block for 

Add New Content. 

Enabling Blocks 

To enable the new block, browse to the Block administration section by clicking the 
Administer | Site building | Blocks link, or by navigating to ad mi n/bui I d/bl ocks. 

Enable the Add New Content block on the Left Sidebar. Drag and Drop the blocks 
in the order you want them. 

Adding Menu Items into the Menu 

To begin with, return to the menu administration screen by clicking the Administer 
| Site building | Menus link, or by navigating to admi n/bui I d/ me n u . Click the 
Navigation link to edit the navigation menu, and then click the edit link for the 
Create content menu item. As shown in the following screenshot, move the Create 
content menu item to the Holding Tank menu. 
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Once you have moved the menu item into the Holding Tank, click the Save button 
to submit the form and save your changes. 

By moving items into the Holding Tank, you remove them from the menu 
administration screen and the menus/blocks presented to the end user. If you do not 
want to use the Holding Tank, you can disable the individual menu items. The only 
real difference is that moving the unused menu items to the holding tank reduces 
visual clutter for people administering the menus. 
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Now that we have moved the entire Create content menu into the Holding tank, 
the options to add content are removed from the default navigation menu. The 
remaining step requires that we move the individual menu items into the Add New 
Content menu we created earlier in this section. 

To do this, click the edit link next to a menu item you want to move. 



Then, place the menu item into the Add New Content menu. 
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Repeat these steps for all of the content types you want to move. 


Add New Content 

° Assignment 
° Audio 
° Blog post 
° Bookmark 
° Image 
° Page 
° Story 
° Video 


When you are done, your users will have a distinct menu to use when they need to 
add content. 

Populate the Primary Links 

In this step, we will add some useful links into the Primary links menu. As you 
populate the Primary links, think about the work your site members will be 
performing. You want your primary links to act as doorways to their most 
commonly-performed tasks. 

The process for adding menu items into the Primary links is just the same as moving 
them into other menus. As shown in the following screenshot, when editing an 
existing menu item, select Primary links as the Parent item. 


Parent item: 


<Primary links> 


The maximum depth for an item and all its children is fixed at 9. Some menu 
items may not be available as parents if selecting them would exceed this limit. 


Adding a Post Directly to a Menu 

Users in a role with administer menu privileges can assign new posts directly into 
existing menus. For this example, we will assign our home page post, created earlier 
into this chapter, into the Primary links. 
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To return to the home page, click the logo or the site name in the top left corner of 
your screen. Then, click the edit tab to edit the post. 

To be able to edit the post, you must be logged in as a user with the 
sufficient privileges. 

As shown in the following screenshot, the Menu settings are at the top of the page. 





Home > Welcome to the Site! 

Welcome to the Site! 

Title: * 


View 12a Track 


| Welcome to the Site! 


v Menu settings 

Menu link title: 


|Home| 


The link text corresponding to this item that should appear in the menu. Leave blank if you do not wish to add 
this post to the menu. 


Parent item: 


1 <Primary links> 


The maximum depth for an item and all its children is fixed at 9. Some menu items may not be available as 
parents if selecting them would exceed this limit. 

Weight: 


I o iYJI 

Optional. In the menu, the heavier items will sink and the lighter items will be positioned nearer the top. 


0 Show summary in full view 

Body: 

I m Source | » | M | ■ <7 | % ft 0 □ si © ® 

I B I U an I X 2 I |E := I it jfifj m rn % Break Bit 


| Format Normal 


Enter Home as the Menu link title, select Primary links as the Parent item, and 
submit the page. 
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Once you have saved the page, you will see the link to Home appearing in the 
Primary links, as shown in the following screenshot: 



admin 

° My account 
° Student blog 
° Teacher blog 
° Log out 


Home Assignment calendar 


Packt and Drupal Open Source Goodness 


Search this site: 


Welcome to the Site! 


Edit Track 


Search 


Add New Content 

° Assignment 
0 Audio 
0 Blog post 
° Bookmark 
° Image 
° Page 
° Story 
° Video 


Page Welcome to the Site! has been updated. 
This is home page text. 


The Primary links appear in the top right corner of the screen as text links. 

As noted above, different themes present the Primary links in different ways. For 
example, some themes display Primary links as tabs or buttons. For a complete 
look at contributed themes and how they display the primary links, see 
http://drupal . org/proj ect/themes. 

Adding a New Menu Item 

In some cases, such as creating a menu item that links to an external site, you will 
need to add a new menu item into an existing menu — for example, you might want 
to link to your main school site from the class website. 

For this example, we will add a link to http: / /drupal .org.At the risk of stating the 
obvious, you can use these same steps to place a link to any site in any menu. 
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To begin with, return to the menu administration screen by clicking the Administer 
| Site building | Menus link, or by navigating to a d mi n / b u i I d / me n u . Click the 
name of the menu you want to edit. For this example, click Primary links. 

To add a menu item, click the Add item tab, as shown in the following screenshot: 
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For each new menu item, you need to specify a: 

• Path: this can be internal or external 

• Menu link title: this text will be displayed in the menu 

• Description: this text will be displayed when hovering over a menu item 

• Parent item: to determine where the new menu item will be displayed 

Click the Save button to submit the form and create the new menu item. 

After the menu item has been saved, you are redirected to a page where you can 
reorganize the menu items via drag and drop. 

Blocks and Block Placement FAQ 

Due to their relationship to menus, the full range of functionality offered by blocks 
can remain unclear. This section addresses some commonly-asked questions about 
using blocks. 


What is a Block? How is it Different than a Menu? 

Blocks and Menus complement one another. Menus provide a way to create, group, 
and organize links. Blocks then display those menus. 


What is a Region? 

Regions are specific places on the page that can be used to display content. Regions 
can be used in conjunction with blocks, as blocks can be dropped into any pre¬ 
defined region. Most of Drupal's core themes have five regions enabled: Header, Left 
sidebar. Right sidebar. Content, and Footer. If you navigate toadmi n/bui I d/bl ock 
you can see the default location of these regions. These five regions are identified in 
the following screenshot. 
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What Else can I do with a Block? 

A lot! You can create custom blocks that use HTML markup, or blocks that use PHP 
code. You can limit block visibility by user role, and by path. To get a sense of the 
full range of what can be done with blocks, check out the options available when you 
add a new block, atadmi n/bui I d/bl ock/add. Fully exploiting the power of blocks 
requires a working knowledge of PHP; in this book we explore some of these options 
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in context. The Drupal handbook includes a selection of PHP snippets related to 
blocks, athttp://drupal , org/ node / 21867. However, when using a snippet from 
the handbook, you should always check two things: 

1. Make sure that the snippet is for the correct version of Drupal, as snippets for 
Drupal 5 will not work for Drupal 6 

2. Test your snippet in a page first by using the "Preview" option. This allows 
you to make sure that the snippet works as advertised, as blocks do not have 
a "Preview" option 

Can I Make a Block Visible to Specific Roles or on 
Specific Pages? 

Yes. Every block has customizable block visibility settings. To access these 
settings, click the Administer | Site building | Blocks link, or navigate to 
ad mi n/bui I d/bl ocks. 



As shown in the preceding screenshot, block visibility can be set by role and by URL 
path. So, for example, a block could be made to disappear whenever content is being 
added or edited by using the Page specific visibility settings. Set the block to Show 
on every page except the listed pages, and enter the following URLs: 

• node/add/* 

• node/*/ edit 
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As the above example implies, you can use wildcards in the path name. 

Changing Settings via the Admin Menu 

Between creating custom menus and blocks, and the various options available 
through the administrative screens, you have a fair amount of control over the look 
and feel of your site. In this section, we will look at these options. 

The Site Information Page 

Navigate to the Site information page by clicking the Administer | Site 
configuration | Site information link, or by navigating to ad mi n/setti n g s / 
si t e- i nf or mati on. 

This page contains some basic options that can be customized for your site. 


Packt and Drupal Open Source Goodness 



Search this site: 

1 |[ Search ] 

billfitzgerald 

° My account 

t> Create content 

° Recent posts 

° Log out 

Site Administration 

v Administer 

i> Content management 
t> Site building 
v Site configuration 
° Actions 
° Administration 
theme 

° Clean URLs 
° Date and time 
o Error reporting 
° File system 
° File uploads 
° Image toolkit 
° Input formats 
l> Logging and alerts 
° Performance 
0 Search settings 
° Site information 
° Site maintenance 
•> User management 
P Reports 
° Help 


Site information 

Name: * 


|Packt and Drupal 


e of this website. 


E-mail address: * 

|contact@funnymonkey.com~ 


The From address in automated e-mails sent during registration and new password requests, and other notifications. (Use 
an address ending in your site's domain to help prevent this e-mail being flagged as spam.) 

Slogan: 

|Open Source Goodness 


Your site's motto, tag line, or catchphrase (often displayed alongside the title of the site). 

Mission: 


Your site's mission or focus statement (often prominently displayed on the front page). 

Footer message: 


This text will be displayed at the bottom of each page. Useful for adding a copyright notice to your pages. 

Anonymous user: * 

|Anonymous 


The name used to indicate anonymous users. 

Default front page: * 

http ://w ww.alphabetademo.com/drupal6/ |node 


The home page displays content from this relative URL. If unsure, specify "node". 


[ Save configuration ] [ Reset to defaults - ] 
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As you can see in the preceding screenshot, the Name and Slogan appear on every 
page of the site. 

The Mission can be used to display a customized message on the home page—for 
example, on school holidays you could use the Mission to wish your students a nice 
holiday, and tell them their assignment for over the break. 

The Footer message is used to display a customized message along the bottom of 
the page. 

Both the footer and the mission can contain HTML markup, which allows you to 
create links, display images, embed audio, and so on, in these regions if you desire. 

The Default front page has been covered earlier in this chapter. 


Theme Settings 

Theme settings can be set globally and also individually within a theme. If you want, 
you can allow users to choose their own theme. As the site administrator, you get to 
specify what themes are allowed. Global settings can be set for use site-wide 
among all themes; however, you can also override these settings within the 
individual themes. 

In this section, we will look at enabling themes, adjusting Global settings, and then 
adjusting the settings for the Garland theme, one of Drupal's core themes. 
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Enabling Themes 

To view the list of installed themes, click the Administer | Site building | Themes 
link, or navigate to a d mi n / b u i I d / t h e me s . On this page, you will see a list of all of 
the installed themes, as shown in the following screenshot: 


Themes 


Configure « 


Select which themes are available to your users and specify the default theme. To configure site-wide display 
settings, click the "configure" task above. Alternatively, to override these settings in a specific theme, click the 
"configure" link for that theme. Note that different themes may have different regions available for displaying 
content; for consistency in presentation, you may wish to enable only one theme. 

To change the appearance of your site, a number of contributed themes are available. 

Screenshot Name Version Enabled Default Operations 


Bluemarine 

Clow tanrtt nwi. __ 

i —Uir. .’JT-'... . Table-based multi-column theme with a 6.X-dev I—I 









Haa» 

Chameleon 





Dorm Mh «roi. Blv.lt no 

l 11111 1 MB 

MW 

Minimalist tabled theme with light 
colors. 

6.x-dev 

□ 

o 





■ 

* — 







Garland 

Tableless, recolorable, multi-column, 6.x-dev 
fluid width theme (default). 


tXAIChUl'M, * 


Marvin 


Boxy tabled theme in all grays. 


6.x-dev 


0 


□ 


nm.rMIUniwi! 


Minnelli - Fixed Width 


Minnelli 

Tableless, recolorable, multi-column, 6.x-dev 0 

fixed width theme. 


® configure 


I 


O 2 


i 


O configure 


h— Pushbutton 

D °vto( fe ^ Tabled, multi-column theme in blue and 6.x-dev 
**~«*»i, w*--’ orange tones. 


□ 


Save configuration J [ Reset to defaults 
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To install a theme, refer to the instructions given in Chapter 3. To enable a theme, click 
the box under the Enabled column, and then click the Save configuration button. 

To set a theme as a site-wide default, click the Default option button, and then click 
the Save configuration button. 

On most sites, you will only need to have one theme enabled. 

Global Theme Settings 

To access the Global theme settings, click the Configure link as indicated by point 1 
in the preceding screenshot, or navigate to ad mi n/bui I d/the me s/setti ngs. 

The global theme settings have four different sections: Toggle display; Logo image 
settings; Shortcut icon settings; and Display post information on. 

Of the four sections within the global theme settings, only one must be set 
in this section: Display post information on. The other three sections can 
be set within the individual themes, and if a setting is set within a theme 
it will override the global setting. 

5 ost Information on 

This setting refers specifically to the text that, by default, accompanies most posts, as 
pictured in the following screenshot: 



Display 


r 


Home 


Moby Dick: Read Chapter 1 

Fri, 12/14/2007 - 01:S3 - billfitzgerald I 


This setting allows you to turn this information on or off for specific content types by 
toggling the options on or off. 


Display post information on 

Enable or disable the submitted by Username on date 
text when displaying posts of the following type. 

0 Blog entry 

n Page 

0 Poll 
0 Story 
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For example, this information is useful for blog posts, where the time and author are 
often relevant. It can be useful to know, for example, if your students are posting 
content after midnight, as that information can be used in a conversation about 
managing workload. 

However, if you are running an event calendar on your site, you will probably want 
to hide the time that event was posted, as this could be confused with the time of the 
actual event. Note that even when this setting is turned off, Drupal still stores this 
information. For example, even with this option turned off for the theme, it could 
still be displayed in a view. 

Once you adjusted these settings to how you want them, save your choices by 
clicking the Save Configuration button. 

Toggle Display 

This section lets you toggle the display of information collected from various areas of 
the site configuration. 
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Items in group 1 can be set by clicking the Administer | Site configuration | Site 

information link, or by navigating to a d mi n / s e 11 i n g s / s i t e - i nformation. These 
settings were covered in detail earlier in this chapter. 

Items in group 2 can be set by clicking the Administer | User management | User 

settings link, or by navigating to admi n/user/setti ngs. 

Items in group 3 can be set within the menu system by clicking the Administer | 

Site building | Menus link, or by navigating to a d mi n / b u i I d / me n u. These settings 
were covered in detail earlier in this chapter. 

The Search box is simply a search area displayed within the theme. The Shortcut 
icon is covered later in this section. 

Once you have adjusted the settings to how you want them, save your choices by 
clicking the Save Configuration button. 

Logo Image Settings 

The next two sections — Logo and Shortcut icon —allow you to customize the logo 
displayed on the site's pages and the shortcut icon (also called the favicon) displayed 
in the browser address bar and favorites. 
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A new logo can be uploaded via the form pictured in the following screenshot. Note 
that an oversized logo can break a site layout! 



Once you've adjusted the settings to how you want them, save your choices by 
clicking the Save configuration button. 

Shortcut Icon Settings 

You can upload a custom shortcut icon, also called a favicon, using the form shown 
in the following screenshot: 



You can create favicons using most graphic software, but it is easier to use one of 
the free online favicon creators. My personal favorite is http://www.cha mi, com/ 
html - ki t/servi ces/favi con / — this site will automatically generate a favicon from 
a picture. 

Once you've adjusted the settings to how you want them, save your choices by 
clicking the Save configuration button. 
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Theme-Specific Settings 

As stated above, adjusting the theme-specific settings will override the 
global settings. 

In this tutorial, we are configuring the options for the Garland theme. This theme 
includes a color picker, which allows you to choose specific colors for the different 
elements of your theme. 

The color picker, shown in the following screenshot, provides a way of selecting 
colors for specific theme elements via the web browser. 


Home > Themes 

Themes List 

Global settings . 


Minnelli 


These options control the display settings for the garland theme. When your site is displayed using this 
theme, these settings will be used. By clicking "Reset to defaults," you can choose to use the global settings 
for this theme. 

Color scheme 


Color set: 

Base color: 

Link color: 

Header top: 

Header bottom: |#5ab5ee 
Text color: .EZEZSEI 

Preview 


| Blue Lagoon (Default) y]| 

mi.w.y] 





Lorem ipsum dolor 


Sit amet, consectetur adipisicing elit, sed do eiusmod tempor 
incididunt ut labore et dolore magna aliqua. Ut enim ad minim 
veniam, quis nostrud exerritation ullamco laboris nisi ut aliquip ex ea 
commodo consequat. Duis aute irure dolor in reprehenderit in 
voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur 
sint occaecat cupidatat non proident, sunt in culpa qui officia 
deserunt mollit anim id est laborum. 
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Using the color picker, you can select new colors via drag and drop, and redefine the 
text color, the link color, and the general color scheme. 

Once you have selected a color scheme, save your choices by clicking the Save 
configuration button. 

Looking Under the Hood 

Like most things Drupal-related, you have an overwhelmingly broad range of 
options available to you if you want to tinker with the code that makes your site run. 
While this holds an incredible amount of appeal to those with a DIY spirit, it's a bit 
much for most people. 

If, however, you are one of the statistical minority inclined to roll your sleeves up 
and start messing with such things, this section is for you. 

Additionally, the Drupal handbook has an excellent overview of the theming system 
for Drupal 6, at http: / /drupal . org/theme-gui de. 

Drupal’s Theme Structure 

At the outset, I want to make a couple things clear. First, a detailed analysis of 
Drupal's theming system is beyond the scope of this book. Second, Drupal offers a lot 
of flexibility for those who want to mess around with the code; however, just because 
you can doesn't mean you should. 

Additionally, developing a theme is not complete without checking to see how the 
theme displays in different browsers. This means looking at your site in at least the 
following browsers: Internet Explorer 6 and 7, Firefox on the Mac, PC, and Linux, 
Safari, and Opera. Cross-browser compatibility checking can be incredibly 
time-consuming, particularly when trying to get a complex page to render cleanly 
in both Explorer and Safari. Often, adjusting a value to get a clean display in one 
browser causes a new problem to arise in another. When you edit your theme via 
the settings described above, you minimize the risk of creating more complex issues. 
However, leveraging the full power of design within Drupal requires the editing of 
theme files. 
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With that said, the following screenshot gives an overview of the directory structure 
of the Garland theme. 



css Files 

CSS is an abbreviation for Cascading Style Sheets. Style sheets contain information 
about how the content within your site should be displayed. For background 
information on style sheets, visit http://en.wikipedia.org/wiki/ 

Cascadi n g _ S t yI e_Sheets. 



When working with your themes' CSS files, ALWAYS back up a working 
copy of your theme before making any changes. 


1 


The first place to get started when modifying a theme is within the theme's c s s files. 
In the preceding screenshot you can see the five c s s files that are included with the 
Garland theme; of these five files, we are mostly interested in s t y I e , c s s , as that is 
where the bulk of the information concerning the look and feel of the Garland theme 
is stored. 
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A full exploration of CSS is beyond the scope of this book, but for those interested in 
learning more, the following resources are indispensable and freely available online: 

• The W3 school's CSS tutorial (http:// www. w3s c h oo I s. com/css/): This 
website gives a top-to-bottom tutorial on c s s . Great for beginners looking to 
learn and CSS gurus who don't want to remember every single detail. 

• The Web Developer Toolbar (https://addons. mozi I I a. org/en-US/ 

fi refox/addon/60): This Firefox add-on includes tools that highlight the 
CSS used on a page, and lets you edit it to see the effects of the changes in 
real time. 

• Firebug (https://addons. mozi I I a. org/en-US/fi refox/addon/1843 ): 

This Firefox add-on is a more technical web developer tool that allows you to 
(among MANY other things) highlight specific sections of a page to see the 
CSS in use on that section. 

tpl.php Files 

If you have edited the CSS files of your theme and still haven't achieved the results 
you wanted, you still have another option: editing the code that creates the theme. 
The code that creates the theme is contained within the various *, t p I , p h p files for 
your theme. Additionally, many themes have atempl ate, php file that contains 
functions used by the theme. 

[ ■AT~i When working with your themes 1 * . p h p files, ALWAYS back up a 1 

working copy of the files before changing them. 1 

If you look at the preceding screenshot, you will see several t p I , php files; for 
example: block.tpl.php, comment.tpl.php, node.tpl.php, and page.tpl.php. 

In general terms, the page, tpl , php collects all of the information passed to it by the 
other tpl.php files. This makes the page, tpl , php file of singular importance within 
the theme, as it controls the general layout of every page rendered on your site. 

To effectively work with these files, you need to have some familiarity with PHP. In 
short, by working with these files you have a great degree of control over how your 
site looks. The downside of this power is that, if you make a mistake in editing one of 
these files, you can cause your entire site to crash. 

As I said earlier, a full discussion of Drupal's theming system is beyond the scope of 
this book. However, some quick highlights will serve as a starting point for people 
looking to learn more about building custom themes in Drupal. 
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Custom tpl.php Files 

To create custom pages, make a copy of your original page.tpl.php (or block.tpl. 
php, or node.tpl.php) file and rename it as described below: 

• You can build custom pages based on the node id by creating a page-x.tpl. 
php (where x is the node id of the specific page you want to theme) file. 

• You can create a custom home page for your site by creating a page- 
front.tpl.php file. 

• You can theme blocks differently by region by creating a block -regionname. 
tpl.php file —so, if you created block-footer.tpl.php then this file would 
control how any block placed in the footer region appeared. 

• You can theme separate content types differently by creating a 
node-contenttype.tpl.php file. For example, node-blog.tpl.php can be 
used to customize how blogs are displayed. 

CSS and JavaScript Aggregation 

Drupal 6 comes with the ability to aggregate your c s s and j a v a s c r i p t files. 
Aggregating these files can improve the performance of your site, and it can also 
help eliminate some bugs in Internet Explorer. Turn on aggregation after you have 
configured your site to its desired settings. Developing your site with aggregation 
enabled can cause delays in seeing the results of changes and tweaks, which can 
complicate the design process. 

To aggregate your CSS and JavaScript files, click the Administer | Site configuration 
| Performance link, or navigate to a d mi n / s e 11 i ngs/performance, and select the 
appropriate options in the Bandwidth optimizations settings. 

Additional Resources 

The Drupal handbooks contain a wealth of good information on developing and 
customizing themes. Two good places to start in the handbooks are: 

• The theme snippets page athttp://drupal . org/ node/ 45471 — this page 
contains user-submitted theme modifications 

• The theme HowTos page at http://drupal.org/node/22803— a collection 
of css and php-based solutions for a variety of theme-related issues 

Additionally, there is a Drupal Themer Module available as part of the devel 
module. This module can be used by advanced designers to help develop custom 
themes. For more details, see http://drupal . org/ p r o j ect/devel . 
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Summary 

In this chapter, we discussed some of the tools available to customize the look and 
feel of your site. The discussion examined how to use menus and blocks effectively, 
and how to use different administrative options to alter the basic design elements of 
your site. 

Finally, for the intrepid souls who are not content to use only the options given to 
them via the admin screens, we made a brief examination of how to customize a 
theme via the style sheets and the actual PHP code that generates the theme. 
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Backup, Maintenance, 
and Upgrades 


Backup and maintenance procedures are among the more onerous tasks of 
maintaining a website. These procedures are detail oriented, and they require a level 
of geek-like work that many people simply don't enjoy. Additionally, many users 
have the expectation that a website, once set up, will run itself. 

Unfortunately, just about everything in life — a car, a computer, a relationship, a 
website—requires work to run smoothly. In this chapter, we will go over the steps 
that you need to take to keep your site safe and secure. 

The instructions in this chapter are intended for teachers running a site to support 
their classes, or for a technology department at a small school — for example, for 
people running under ten sites overall. For larger Drupal installations, or for people 
developing applications using Drupal, I strongly recommend a more complex 
support structure using a version control system (CVS, svn, git, bazaar, and so on). 

In this chapter, we will cover setting up cron jobs, site backups, site upgrades, and 
setting up a backup and test environment. 


Setting Up Cron Jobs 

In Drupal, cron jobs are used to schedule and perform various maintenance tasks 
on your site. Within a Drupal site, cron jobs trigger several important tasks, such 
as building the search index for your site, and generating and updating log files. 
Frequently, other modules will also set up actions that are triggered by cron jobs. 

The name cron job comes from the Linux utility cron, an automated 
scheduling program installed on Linux systems. For an overview of cron, 
visit http://en. wi ki pedi a. org/wi ki / Cron. 
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The easiest way to set up cron jobs is via the Poormanscron module, available at 
http://drupal . org/proj ect/poormanscron. Download and install this module 
as described in Chapter 3. Once the module is installed, click the Administer | Site 
configuration | Poormanscron link, or navigate to a d mi n / s e 11 i ngs / poormanscron. 


Home 

Poormanscron 

The settings provided here allow you to administer Poormancron. 

[more help...] 

Time intervals 

Cron runs interval: 

I 180 I 

Minimum number of minutes between cron runs. Cron vail actually execute during the first page request after the interval has elapsed. 

Retry interval: 

|2° I 

The number of minutes to wait after a cron run error before retrying. 


Logging 

Log successful cron runs: 

| Yes S)| 

If you want to log successful cron runs to the Drupal watchdog, say Yes here. If those messages annoy you, disable them by selecting 
No. 

Log poormanscron progress: 

I Yes iVil 

If you want to log the progress of a poormanscron run to the Drupal watchdog, say Yes here. If those messages annoy you, disable 
them by selecting No. 


| Save configuration ] | Reset to defauItT] 


The configuration options allow you to specify how frequently, in minutes, cron 
should run. For most learning sites, cron should run every two to three hours. When 
you are setting up your site and tweaking the configuration options, you should set 
both Log successful cron runs and Log poormanscron progress to Yes, as this will 
provide a point of reference that everything is running as it should. 

You can also configure cron jobs to run from the command line, and some Web 
hosting companies have utilities that simplify the creation of cron jobs. For 
information about setting up cron jobs within different hosting environments, 
refer to the Drupal handbook at http://drupal.org/cron. 
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Backup and Maintenance Overview 

Drupal sites run as a result of an interaction between four components: 

• the database 

• the core codebase 

• the contributed modules and themes directory, along with the 
setti ngs. php file 

• the files directory 

In practice, we will back up the modules, theme, and files directories together, as 
they all reside in the sites directory. However, when it comes to updating the site, it 
is helpful to think of them as separate from one another. When upgrading sites, 
we treat the core codebase, contributed modules, and contributed themes in 
different ways. 

Also, as part of your backup and maintenance strategy, you should create a 
document that lists all of the critical usernames and passwords for your site. 

This list of critical data includes: 

• Username and password of UID1 on your site. 

• Username, password, and database name of your database. 

• Username and password for FTP (or preferably SFTP) access to your site 

• Username and password for SSH (or shell) access to your site. 

At the risk of stating the obvious, this document should be stored in a very secure 
place. For a more secure setup, you should use a tool like Password Gorilla, available 
at h 11 p: / / www. fpx, de/fp/Software/Gori I I a. 

Backing Up the Codebase 

In order to create a back up of the codebase, use your FTP client to connect to 
your server. 

Ideally, for reasons of download speed and stability, this should not be done over a 
wireless connection. 

When the download is complete, you will have a full copy of your working codebase 
saved on your computer. 
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Later in this chapter, we will cover using the command line to speed up this process, 
but, for those of you who want to avoid the command line, you can make adequate 
backups of your codebase using FTP. 

[ PITT While using FTP to back up your site will work, it will certainly get | 

unwieldy over time, particularly as people store files on your site. I 

Automating Backups Using DB 
Maintenance 

The DB Maintenance module simplifies the process of backing up your site by 
automating the key steps of site maintenance. To get started, download the 6.X-2 
version of the module from http://drupal . org/proj ect / dbmai ntenance, and 
install it as described in Chapter 3. 

Once you have the module installed, click the Administer | Site configuration | DB 
Maintenance link, or navigate to ad mi n/setti ngs/dbmai ntenance. 

As you work with your site over time, you will fine-tune the settings for the DB 
Maintenance module. As we cover how to configure this module, we will discuss 
how to tune the settings. 

The DB Maintenance module performs three related maintenance tasks: 

1. Optimizing the database (which is covered in more detail later in this 
chapter) 

2. Backing up the database 

3. Backing up the files directory 

Once the database and files have been backed up, they are compressed and stored on 
the server, and a site administrator is sent an email about the backup. 

Configuring the Database Optimization 
Options 

The DB Maintenance module provides several options for optimizing 
your database. 
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To start, as shown in the preceding screenshot, you should use the 
following options: 

• Log OPTIMIZE queries: selected 

• Attempt REPAIR of table if OPTIMIZE is problematic: selected 

• Optimize tables: Bi-Weekly 

• Tables in the Drupal database: select all of the tables listed 

In most cases, attempting to repair tables will work. In some cases, 
however, if the repair fails the database may be left in a further 
compromised state. As a result, in order to be completely safe, make sure 
you have a working backup of your database before enabling this option. 

When you are initially setting up your site, you should always choose to optimize 
all tables, and always log what tables get optimized. By setting your site to optimize 
tables bi-weekly, you will be able to use your log files (available at Administer | 
Reports | Recent log entries link, or by navigating to ad mi n / report s / dbl o g ) to see 
which specific tables need to be optimized over time. You can then select to optimize 
only those tables, which will make your site more efficient. At that point, you might 
also want to adjust the frequency with which the tables are optimized. 



[339] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 
















Backup, Maintenance, and Upgrades 


Configuring the Database and Files Backup 
Options 

When using the DB Maintenance module to back up your database and files, you can 
set different backup intervals for each item. 


Database Backup frequency: 

| Daily 

How often to backup the database. This is the most frequent this will run, but no more often than the frequency of the 
drupal cron script. 

Files Backup frequency: 

I Weekly i^| 

How often to backup the files directory. This is the most frequent this will run, but no more often than the frequency of 
the drupal cron script. 

Backup directory: 

l/tmp I 

Directory to store backup files in 

Path to tar: 

|/bin/tar | 


Path to mysqldump: 

|/usr/bin/mysqldump 


Email address to notify: 

| maintenance@funnymonkey.com | 

List of email addresses to notify when tasks run. Seperate multiple addressses with a comma. Leave empty for no 
notification 


The first two configuration settings shown in the preceding screenshot. Database 
Backup frequency and Files Backup frequency, allow you to specify how often 
these two items will be backed up. In general terms, the database should be backed 
up daily, and the files directory should be backed up at least weekly. If your site 
involves a lot of file uploads, then backing up the files on a more regular basis 
is recommended. 

The next setting. Backup directory, allows you to specify the directory, in which the 
backup files will be stored. The default given here, the /1 mp directory, exists on most 
Linux servers, but you can choose to have the backup stored anywhere you like. 
Ideally, your backup should be stored outside of any directories that can be accessed 
via the Web. 
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In selecting a backup directory, make sure that it is accessible via ftp, and 
that it can be written to by Drupal. In most cases, if you create a specific 
backup directory, that will work without issue. 

Moreover, while the / t mp directory is the default directory for this 
module, on some systems it is cleared out periodically. This can create 
the appearance of backups not being stored properly. In short, retrieve 
backup files promptly. 


The next two settings. Path to tar and Path to mysqldump, allow you to specify the 
location of two utilities required for backing up and compressing your database and 
files directory. The default values provided by the module are where these utilities 
generally reside on most Linux servers. 

On a shared hosting account, tech support can verify these locations for 
you. You can also access your server via SSH and use either the whereis 
or which commands (depending on how your server is configured, 
and assuming these utilities are installed) to determine the location. For 
example, entering the command which tar will return the path to tar. 

The final setting. Email address to notify, allows you to specify the email addresses 
of the people who will be informed when the backup has occurred. These people will 
be responsible for connecting to the server via FTP and retrieving the files. After the 
files have been stored in a safe place, they should be removed from the web server in order 
to conserve disk space. 

Summary: Using DB Maintenance to 
Automate Backup and Maintenance 

The DB Maintenance module automates the process of backing up those elements of 
your site that change on a regular basis. The database and file backups, when used in 
conjunction with a backup of your working codebase, is all you need to run your 
site securely. 
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At this point, your site will be running securely if you have: 

1. A backup of your core codebase. 

2. A backup of all contributed modules and themes, and a copy of your 
setti ngs. php file (that is, a copy of the sites directory). 

3. A configured DB Maintenance module that is taking copies of your database 
and files directory. These files will be retrieved from the server by a trusted 
and responsible site administrator. 

These three things make up the core of your backup plan. If you have completed 
these elements, your site is now running securely. 

Caring For Your Database 

The database containing your site's data is the single most important piece of your 
site. It contains all of the configuration options you have put into your site, as well 
as the countless hours of work completed by your students. In short, it needs to 
be treated with care. Taking care of your database ensures that your site will run 
smoothly over time. 

As you use your site, your database tables will benefit from optimization. This step, 
although not technically necessary in most cases, can help prevent errors over time. 
Optimizing tables can be compared to giving a car a tune-up, or with defragmenting 
a computer's hard drive. 

Table optimization can be automated by using the DB Maintenance module, but if 
you choose not to use that module you have other tools at your disposal. 

Using PHPMyAdmin as a Maintenance and 
Backup Tool 

PHPMyAdmin comes with some useful, browser-based tools for backing up and 
optimizing your database. 

Optimizing Tables Using PHPMyAdmin 

As pictured in the following screenshot, PHPMyAdmin contains a great utility for 
optimizing tables and also shows when these tables need optimizing. 
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K9 localhost ► |&i drupal6 

EgStructure ,gSQL , Search /Query ‘.Export Import ^Operations ^Privileges gs;Drop 


I 



Table 


Action 



Records^ 

Type 

Collation 

Size 

Overhead 

□ 

access 

eS 



9 

X 

0 

MylSAM 

utf8_general_ci 

1.0 Ki3 

- 

□ 

accesslog 

i dr 



f 

X 

0 

MylSAM 

utf8_general_ci 

1.0 KiB 

- 

□ 

actions 

SB eS 

B 

*i 

m 

X 

10 

MylSAM 

utf8_general_ci 

5.7 KiB 


□ 

actions_aid 

dr 



a 

X 

0 

MylSAM 

utf8_general_ci 

1.0 KiB 

- 

□ 

authmap 

4 ES 

E 


m 

X 

0 

MylSAM 

utf8_general_ci 

1.0 Ki3 

- 

0 

batch 

■1* 

B 


» 

X 

0 

MylSAM 

utf8_general_ci 

4.8 KiB 

1.8 KiB 

□ 

blocks 

■ dr 

B 


9 

X 

28 

MylSAM 

utf8_general_ci 

8.0 KiB 

" 

□ 

blocks_roles 

B eS 


»■ 


X 

0 

MylSAM 

utf8_general_ci 

1.0 KiB 


□ 

boxes 

m Gi 



[9 

X 

0 

MylSAM 

utf8_general_ci 

1.0 KiB 

- 

0 

cache 

H 

Ef 

B 


9 

X 

1 

MylSAM 

utf8_general_ci 

141.0 KiB 

91.8 KiB 

□ 

cache_block 

. eS 

B 


9 

X 

0 

MylSAM 

utf8_general_ci 

1.0 KiB 

- 

0 

cache_filter 

B 

£ 

B 


1 

X 

1 

MylSAM 

utf8 general ci 

8.2 KiB 

1.5 KiB 

0 

cache_form 

■ 

eS 

B 


9 

X 

4 

MylSAM 

utf8_general_ci 

67.1 KiB 

13.e Ki3 

0 

cache_menu 

■ 

El 

B 


ffl 

X 

3 

MylSAM 

utf8_general_ci 

301.6 KiB 

66.3 Ki3 

□ 

cache_page 

a a 



9 

X 

0 

MylSAM 

utf8_general_ci 

1.0 KiB 

- 

0 

cache_update 

' Tprf 

B 


t 

X 

0 

MylSAM 

utf8_general_ci 

9.8 KiB 

3.8 KiB 

□ 

comments 

H ni 



9 

X 

0 

MylSAM 

utf8_general_ci 

1.0 KiB 


□ 

contact 

® ] Hi 



■ 

X 

0 

MylSAM 

utf8_general_ci 

1.0 Ki3 



Select the checkbox to the left of all of the tables that you want to optimize, and then 
choose the Optimize table option as shown in the following screenshot: 
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Although you can optimize tables using the command line, doing so 
requires more technical skills than using PHPMyAdmin. MySQL syntax 
can change between versions, and PHPMyAdmin is a useful and easy tool 
for these types of maintenance procedures. 


Manually Backing Up the Database 

The DB Maintenance module automates database backups for you. However, there 
are still times when you might want to or need to back up your database manually, 
such as before a site upgrade. 

Before you back up your database, you should optimize the tables in the database. 

Backing up the Database via PHPMyAdmin 

PHPMyAdmin has an export utility that can be used to back up your database. As 
shown in the following screenshot, you can access it by clicking the Export tab. 



$ localhost ► p drupal6 
Iffi Structure 5 g;SQL , Search fc. Query 



ip Export galmport ^Operations ^Privileges 


Table 

Action 

Records^ Type 

Collation 

□ access 

p= iSr [j 

i X o MylSAM 

utf8_general_ci 
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The Export screen, shown in the following screenshot, contains three sections: 


£1 localhost ► gi drupal6 

^Structure ,gSQL , Search ^aQuery giExport ^Import ^Operations ^Privileges 3<Drop 


■View dump (schema) of database- 
■ Export- 


accesslog 

actions 

actions_aid 

authmap 

batch 


Select All / Unselect All 
O CSV 

O CSV for MS Excel 

O Microsoft Excel 2000 

O Microsoft Word 2000 

O LaTeX 

O Open Document 
Spreadsheet 

O Open Document Text 

O PDF 

® SQL 

O XML 


•SQL options- 

Add custom comment into header (\n splits lines) 


□ Enclose export in a transaction 

□ Disable foreign key checks 
SQL compatibility m ode 

NONE 

© 

0 Structure- 

□ Add DROP TABLE / DROP VIEW 

□ Add IF NOT EXISTS 
0Add AUTOJNCREMENT value 
0 Enclose table and field names with backquotes 

rAdd into comments- 


□ Creation/Update/Check dates 


r 0 Data- 

□ Complete inserts 

□ Extended inserts 
Maximal length of created query 
50000 


□ Use delayed inserts 

□ Use ignore inserts 

0 Use hexadecimal for binary fields 
Export type 
INSERT v 


r 0 Save as file- 

File name template (1 1 dbname_date ( 0 remember template) 

Compression: o Node o "zipped" ® "gzipped" o "bzipped" 


d°] 


1. Export —in this section, you generally won't need to change the defaults. 
Select all of the tables in your database, and export them as an SQL file. 

2. SQL Options —in this section, leave the default values (as shown in the 
preceding screenshot) unchanged. 


[345] 



This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 
















































Backup, Maintenance, and Upgrades 


3. Save as file —in this section, give the file a descriptive name. I recommend 
a name that combines the name of the database with the date of the backup. 
This naming convention simplifies the process of finding your most current 
backup if you need it. So, for a database named drupal6 that is backed up on 
January 15, 2008, the name of the backup file would be drupal6_15jan2008. 
Also, note that in this section, we have selected "gzipped" as the file type. 
Selecting this option reduces the size of your backed up database. 

For database files that are too large to be backed up using PHPMyAdmin, 
both the DB Maintenance module (covered earlier in this chapter) and 
command-line backups (covered in the next section) sidestep this issue. 

Backing Up Your Database via the 
Command Line 

In this chapter, we provide instructions that eliminate the need to use the command 
line. However, knowing how to use the command line can save you time. Using the 
command line can be confusing, as the command line is not intuitive; you need to 
know the precise commands and syntax to use. However, for clearly-defined tasks, 
knowledge of the command line can be very useful. 

When working from the command line on your server, you should create a staging 
directory. You will use this directory as a place to upload files, to store backups, and 
as a place to extract any files prior to moving them into your site. Ideally, this staging 
directory is outside of the web root. 

The web root is the highest-level directory on your server that can be 
accessed via a web browser. Any files or directories within this directory 
are said to be within the web root. Placing a file or directory outside the 
web root means that it cannot be accessed via a web browser, but that it 
can be accessed via FTP or SSH. 

To use the command line, you will need shell access to SSH into your web server. 

On Mac and Linux machines, you can use the terminal application. On PCs, you can 
use Putty, available at h 11 p : / / www. chi ark, greenend. org. uk / -sgtat ham/ putty. 

For an overview of working via the command line, see the Linux command line 
tutorial at h 11 p : / / www. tuxfiles.org/linuxhelp/cM.html. There are numerous 
other comparable online tutorials are available. 
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Command Line Database Backups—The Short 
Version 

If you are familiar with the command line, here are the commands you will need 
once you have SSH'ed into your server: 

1. mkdir backup (this creates the staging directory you will use to store your 
backups. You will only need this command once. This directory should be 
outside of the web root.) 

2. c d backup (This moves you into the backup directory.) 

3. mysqldump --skip-lock-tables -u databaseuser -pdatabasepassword 
databasename > filename.sql (This command is used to back up 
your database.) 

Command Line Database Backups—The Full 
Explanation 

1. After logging in to your server, use the Is - a I command to list the contents 
of the directory that you are currently in. 


alphabetademo.com - PuTTY 


total 68 

drwx- 

11 

devolici 

vuser 

4096 

drwxrwxr-t 

3 

root 

vuser 

4096 

-rw- 

i 

devolici 

vuser 

8603 

drwxr-xr-x 

2 

devolici 

vuser 

4096 

drwxr-xr-x 

6 

devolici 

vuser 

4096 

drwxr-xr-x 

2 

devolici 

vuser 

4096 

drwxr-xr-x 

5 

devolici 

vuser 

4096 

drwxr-xr-x 

7 

devolici 

vuser 

4096 

drwxr-xr-x 

4 

devolici 

vuser 

4096 

-rw- 

i 

devolici 

vuser 

10498 

drwxr-xr-x 

5 

devolici 

vuser 

4096 

drwxr-xr-x 

6 

devolici 

vuser 

4096 

drwxr-xr-x 

3 

devolici 

vuser 

4096 

lrwxrwxrwx 

1 

devolici 

vuser 

13 

| [devolicious][~ 

1 




dl@® 

Jan 22 15:14 . j 
May 16 2007 .. B 
Dec 18 03:18 .raysql_history H 
Dec 20 16:08 bin B 
Jan 22 15:14 bonzo B 
Jan 27 07:36 download B 
Dec 20 16:09 include B 
Jan 15 14:48 jgraham B 
Dec 20 16:09 lib B 
Jul 3 2007 inbox 

Dec 17 23:02 monkeytrash B 
Dec 20 16:09 share B 
Jan 17 12:18 src ^B 
May 16 2007 www -> /var/www/html H 


2 . 


Use the mk d i r command to create a directory named backup: 

mk di r backup 
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3. Use the Is - a I command to see your newly-created directory, and the c d 
command to move into your newly-created directory. Refer to the following 
figure for more detail: 

Is - a I 
cd bac kup 


,/ alphabetademo.com - PuTTY 






S0® 

I [devolicious] [~ 

]$ Is -al 








total 72 










drwx- 

12 

devolicl 

vuser 

4096 

Jan 

27 

13:06 



drwxrwxr-t 

3 

root 

vuser 

4096 

May 

16 

2007 



-rw- 

1 

devolici 

vuser 

8603 

Dec 

18 

03:18 

.mysql history 


drwxr-xr-x 

2 

devolicl 

vuser 

4096 

Jan 

27 

13:06 

backup 


drwxr-xr-x 

2 

devolici 

vuser 

4096 

Dec 

20 

16:08 

bin 


drwxr-xr-x 

6 

devolici 

vuser 

4096 

Jan 

22 

15:14 

bonzo 


drwxr-xr-x 

2 

devolici 

vuser 

4096 

Jan 

27 

07:36 

download 


drwxr-xr-x 

5 

devolici 

vuser 

4096 

Dec 

20 

16:09 

include 


drwxr-xr-x 

7 

devolici 

vuser 

4096 

Jan 

15 

14:48 

jgraham 


drwxr-xr-x 

4 

devolici 

vuser 

4096 

Dec 

20 

16:09 

lib 


-rw- 

1 

devolici 

vuser 

10498 

Jul 

3 

2007 

inbox 


drwxr-xr-x 

5 

devolici 

vuser 

4096 

Dec 

17 

23:02 

monkeytrash 


drwxr-xr-x 

6 

devolici 

vuser 

4096 

Dec 

20 

16:09 

share 


drwxr-xr-x 

3 

devolici 

vuser 

4096 

Jan 

17 

12:18 

src 


Irwxrwxrwx 

1 

devolici 

vuser 

13 

May 

16 

2007 

www -> /var/www/html H 

I [devolicious] [~ 

$ cd bacJcup( 






□ 


4. Now that we have created and moved into our backup directory, we can 
actually back up the database using the my s q I d u mp command. See the 
highlighted section in the following screenshot for a detailed example. 






ITfi'y' 

<Sfvx------ i 2 dfvot let 

_. __ _ 


'4 Jib 21 13tl 



drvanrxr-t 3 root 

£ 


'4 Key 14 20^ 



drvxt • ■ % 2 dtvnlici 

vueer 


>4 Jea 37 14:1 

>2 backup 


drvit'is*! 2 dtvcUci 

vueer 


>4 Dec 20 14:( 

>0 bia 


<srvit*ftt*s 4 dtvoHci 

vueer 


>4 Jen 22 IS:: 
>4 Jea 27 07:2 

14 beaso 


5 dtvolict 
<]fVXt ‘XS *s 7 dtvol td 
<3rvar-x:-i 4 dtvolict 

vuter 

rue*; 

401 

>4 Dec 20 14:1 
>4 Jea IS 11:1 
>4 Dec 30 14:1 

>0 catena* 

*0 1 lb 


dr«x:*xt*s S devolicl 
drwit’iS'S 4 devolici 

£ 

rue* ? 


>4 Dec 20 14:( 

>2 BD&ktyirMft 

>0 there 


drvxs*ts*i 3 devolici 

rue* ; 


*4 Jea 17 121! 

0 ere 


ltvsrvxfwx 1 devolici 

VUff £ 


3 Key 14 20< 

)7 ww »> /ver/wv/at&l 


_... . __ 

[devolicious][-/backup]$ 

CUfJ 

mysqldurap 

—skip 

)-lock-tables 

-u drupal6 -p>drupal6 drupal6 


> drupal6 27jan2008. sql| 
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The my s q I dump command accepts the following switches (options): 
--skip-lock-tables: Although this option won't be necessary on every 
server, including it can help avoid error messages that will impede 
your progress. 

-u: This option specifies a user with rights to your database. This user 
should be the same as the user specified user when you created your site 
as described in Chapter 2. 

-p: his option specifies the password of your database user. Do not 
include a space between the -p and the actual password. 

The next option in the my S q I d u mp command is the database name; in the 
example used in the preceding screenshot the database name is drupal6. 
The user, password, and database name will all be the same as what you 
used when installing your site. 

> filename.sql: This option specifies the name of your backup file. 


5. To verify your backup, use the Is - a I command to list the contents of the 
backup directory. See the highlighted section in the following screenshot 
for details: 

Later in this chapter, we cover how to test your backup by recreating your 
NO- database on a different server. 


>1 jt >i 


ifg 


An 

An 

Aai 


|U 

fee*#/ 


life 


LA»r1 f 


xt 


[devoliclous]["]$ cd backup 
[devolicious] [^/backup] $ mysqlduinp 
> drupal6_27jan2008.sql 
[devolicious]["/backup]$ Is -al 
total 568 

drwxr-xr-x 2 devolici vuser 

drwx- 12 devolici vuser 

-rw-r—r— 1 devolici vuser 

[devolicious]["/backup]$ | 


-skip-lock-tables -u drupal6 -pdrupal6 drupal6 


4096 Jan 27 14:28 . 

4096 Jan 27 13:06 .. 

565996 Jan 27 14:28 drupal6 27jan2008.sql 
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Command Line Backups of Core 
Codebase, Contributed Modules, 
and Files 

Earlier in this chapter, we took a full backup of the codebase by downloading a copy 
of the codebase via FTP. 

In this section, we will cover how to make code and file backups via the command 
line. We will also break our backup into three separate sections: 

1. The core codebase 

2. Contributed modules, contributed themes, and the setti ngs, php file 

3. The files directory 

These distinctions will be useful later in the chapter when we go over how to 
upgrade your site. 

The Master Backup 

You should perform a master backup when you launch your site, and again after 
upgrading your site. This master backup contains the code and the themes you need 
to run your site. To perform the master backup, you need to copy and archive the 
web directory running your Drupal install. 

In this example, we will back up the site in the drupal 6 directory. 

1. Log in to your server and c d to the staging directory. For more information 
on creating a staging directory, refer to the instructions in the Backing up your 
database via the command line section. 

2. Enter c p -pr / v a r / www/ html/drupal 6 s i t e_ dat e . replace s i t e_ d a t e with 
the site name and the date of the backup 

For the C p command, you will need to specify the path to your Drupal 
install. As shown in the screenshot at the end of this section, you can use 
your FTP client to figure out the path to your site. 

3. Enter tar cvf si tedate. tar si tedate 

4. Enter gzip si te_date. tar — this creates a file named si tedate, tar, gz, 
which contains a compressed version of your entire codebase. 

5. FTP into your site, and download the codebase and the backup of database 
created earlier in the chapter. 
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Remote site: 

/var/www/html/drupal6/ 'j 


B £3 drupal6 


Q indudes 
ffl £2) misc 
SI £S) modules 


Filename / 

Filesize 

File type 

Last modified 

Permissions 

Owner / Group 

Q.. 

£2) indudes 


File Folder 

1/8/2008 12:06:00 AM 

drwxr-xr-x 

devolia vuser 

|£)misc 


File Folder 

1/8/2008 12:06:00 AM 

drwxr-xr-x 

devolia vuser 

£j) modules 


File Folder 

1/8/2008 12:08:00 AM 

drwxr-xr-x 

devolia vuser 

profiles _ 

Q scripts j ^ 


File Folder 

1/8/2008 12:08:00 AM 

drwxr-xr-x 

devolia vuser 


File Folder 

1/8/2008 12:06:00 AM 

drwxr-xr-x 

devolia vuser 

pri sites 


File Folder 

1/8/2008 12:08:00 AM 

drwxr-xr-x 

devolia vuser | 

themes 


File Folder 

1/8/2008 12:09:00 AM 

drwxr-xr-x 

devolia vuser 

l^l .htaccess 

3,488 

HTACCESS ... 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 

0 CHANGELOG.txt 

35,650 

Text Docu... 

1/8/2008 12:05:00 AM 

-rw-r—r— 

devolia vuser 

0 COPYRIGKT.txt 

978 

TextDocu... 

1/8/2008 12:05:00 AM 

-rw-r—r— 

devolia vuser 

b*) cron, php 

262 

PHP File 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 

1^1 index .php 

980 

PHP File 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 

0 INSTALL.mysql.txt 

1,308 

TextDocu... 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 

0 INSTALL.pgsql.txt 

1,075 

Text Docu... 

1/8/2008 12:05:00 AM 

-rw-r—r— 

devolia vuser 

[•) install, php 

45,765 

PHP File 

1/8/2008 12:05:00 AM 

-rw-r—r— 

devolia vuser 

0 INSTALL.txt 

13,226 

TextDocu... 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 

0 LICENSE.txt 

18,064 

TextDocu... 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 

0 M AINTAINERS. txt 

2,080 

Text Docu... 

1/8/2008 12:05:00 AM 

-rw-r—r— 

devolia vuser 

0 robots.txt 

1,627 

Text Docu... 

1/8/2008 12:05:00 AM 

-rw-r—r— 

devolia vuser 

update .php 

22,040 

PHP File 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 

0 UPGRADE.txt 

5,002 

TextDocu... 

1/8/2008 12:05:00 AM 

-rw-r—r— 

devolia vuser 

l^lxmlrpc.php 

352 

PHP File 

1/8/2008 12:05:00 AM 

-rw-r-r— 

devolia vuser 


As seen in the preceding screenshot. Item 1 indicates the path on the server to the 
absolute location of the web directory we will need to archive for the master backup. 
Item 2 highlights the sites directory, which contains the files directory we will need to 
archive during more frequent backups. 

Details on the Command Line 

1. The t a r command compresses files to allow us to store backups using 
less space. 

• c v f : these options stand for: 

° c: create a tarred file 

° v: verbose—list all the files and directories included in 
the tarred file 

° f : the filename of the tarred file will be the next 
option in the command 
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• The filename—as with the database backup, you should give the 
backup a descriptive name. Including the site and the date in the 
filename will help you keep track of your backups over time. 

• The path to the directory to be backed up. If you look at Item 1 the 
preceding screenshot, you can see how your ftp client can help you 
determine the directory locations. Frequently, using your ftp client 
in conjunction with your SSH client simplifies the maintenance tasks 
you need to perform. 

2. The g z i p command compresses the tarred file further, which saves storage 
space for backups. 

Backing up Contributed Modules and Themes 

Log into your server via SSH and c d to your staging directory. 

In this description, we are using the path /var/www/html/dmpal6, 
where drupal6 is the name of the directory from which our Drupal site is 
accessed. When you are doing your backups, you will need to substitute 
this with the path to your site. 

To tar only the modules and the themes, we will need to point specifically to the 
/var/www/htm]/drupal6/sites/all/ directory, using the following command: 

tar cvf modthemesdate.tar / v a r / www/ html/drupal 6/sites/al 1/ 

Alternatively, we could grab a copy of the entire sites folder; this would create a 
backup up copy of all contributed modules and themes used on the site, as well as 
any files uploaded by site members, as well as the setti ngs, php file. To tar the 
entire sites directory, use this command: 

tar cvf enti resi tesdi rdate. tar / v a r / www/ html / drupal 6 / si tes/ 

Whether you have copied only the contributed modules and themes, or the entire 
sites directory, g z i p the folder as described above, and download it from 
your server. 

File Backups 

To back up the files directory, you need to change the path to the directory you want 
to tar. 
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For the master backup, we tarred the /var/www/htm]/drupal6/ directory. To tar the 
files directory, we would need to use the following command: 

tar cvf fi I esdate.tar / v a r / www/ html / drupal 6/ si tes / defaul t/fi I es/ 

Then, gzip the file as described above, and download it from your web server. 

Putting it all Together 

The process of using the command line can be daunting, as the command line doesn't 
give us much in the way of feedback. 

However, getting familiar with the command line can save us time, and help us 
perform important work quickly. 

To put this into perspective, once we have SSH'ed into our server, the following 
commands are all we need to create our master backup: 

cd bac kup 

mysqldump --skip-lock-tables -u databaseuser -pdatabasepass wo r d 
databasename > filename.sql 

tar cvf sitedate.tar /path/to/your/site/ 

gzip sitedate.tar 

Once you have created the master backup, the following commands will create 
snapshots that will allow you to restore the site in the case of a server crash: 

cd bac kup 

mysqldump --skip-lock-tables -u databaseuser -pdatabasepassword 
databasename > filename.sql 

tar cvf filesdate.tar /path/to/your/site/default/fi I es 
gzip fiIesdate.tar 

Although working from the command line is unfamiliar territory, learning the 
commands described in this chapter can allow you to backup your site quickly 
and easily. 

It is also worth noting that the DB Maintenance module automates the 
process of backing up the database and the files directory, making these 
command line steps unnecessary. 
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OK. What Should I Back Up, and When Should 
I Do It? 

At the start of this chapter, we described the four elements that need to be backed up: 

• The database 

• The core codebase 

• The contributed modules and themes directory, along with the 

setti ngs. php file 

• The files directory 

Of these four elements, only two —the database and the files directory—change on a 
regular basis. 

From a practical perspective, this means that we only need to back up the core 
codebase and the contributed modules and themes directory after we have 
upgraded, or installed a new module. 

The files directory and the database, however, change as a result of user activity. 
Therefore, they should be backed up on a more regular basis. 

Verifying that your Backup Works 

Going through the steps required to back up your site is an excellent first step, but 
for a backup to provide true peace of mind you need to know it works. To test your 
backup, you need to use it to recreate your site in a different location. This process 
involves three steps, and is similar to the install process described in Chapter 2. 

1. Create your backup database. 

2. Upload your codebase to the backup server. 

3. Edit the setti ngs. php file to point to your database. 
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Before We Begin: Web Space for Testing Your 
Backup 

To verify that your backup works, you need to test that you can recreate your site. 

This step requires server space that is usually obtained in one of three ways: 

1. Buy an additional test domain: If you do a lot of work with websites and 
want a place to learn, a test domain can be a great resource. If you want to 
teach your class and spend as little time possible dealing with maintenance, 
then one of the other options will be a better fit. 

2. Create a subdomain in your existing account: For example, if your site 
is accessible at h 11 p : www, yoursi te, org, the subdomain would be at 
http://test.yoursite.org. The advantage of the subdomain is that it is 
probably the easiest to set up, as most web hosts will help you to do this, and 
some will even do it for you. The disadvantage of using a subdomain is that 
if your server goes down, you will lose both your backup site and your 
main site. 

3. Set up a test site on your computer using XAMPP (refer to h 11 p: / / d r u p a I . 
org/ node/ 75545 )or MAMP (refer tohttp://drupal . org/ node/ 66187 ). 
This is a useful step if you want to learn more about running a server, but it 
can be too much technical work for many people. 

Creating the Backup Database 

You can use either PHPMyAdmin or the command line to recreate your database. 

Although PHPMyAdmin provides an easier interface to work with, it has some 

limitations, especially when it comes to restoring larger databases. 

First, create a database and a user for that database, as described in Chapter 2. 

Make sure that you keep the username, password, and database name 
of this database in a convenient place, as you will need to specify these 
values in your setti ngs, php file, and you could also need them if you 
need to populate this database via the command line. 
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Recreate the Database via PHPMyAdmin 

Refer to the following screenshot for details. 

1. Click the Import tab on the top-level navigation. 

2. On the Import screen, use the Browse button to select your database. 

3. Note the upload size limit, shown in the following screenshot by Item 3. (If 
your database backup is larger than this, you need to use the command line.) 


localhost ► test_backup 


:>k, 


Eg Structure s gSQL Search &aQuery gjiiExport Ealmport ^Operations gsPrivileges XDr°P 

2 3 


Import 

File to import 




C:\Documents and Sett 

: 

Browse. j 

utf8 



Character set of the file: 

Imported file compression will be automatically detected from: None, gzip, bap2, zip 


-Partial import- 

0 Allow interrupt of import in case script detects it is close to time limit. This might be good way to import large files, 
however it can break transactions. 

Number of records(queries) to skip from start 0 


■Format of imported file 
® SQL 


SQL options 



SQL compatibility mode 
© 

NONE 

V 


Go 


4. Select the correct file, and click the Go button. 

Recreate the Database via the Command Line 

To recreate the database using the command line, you will need to FTP the file 
containing your backed-up database into your staging directory. Then, log into your 
server via SSH, and c d to your staging directory. 
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Populate your database using the following command: 

mysql -u username -p databasename < backupfilename.sql 

Once you have completed these steps, you can view the database using 
phpMyAdmin to verify that the database has been created correctly. 

Uploading the Backup Codebase 

In this chapter, we have covered two ways of backing up the codebase: using your 
FTP client or by tarring and gzipping the file via the command line. If you used 
your FTP client to download the codebase, then simply upload the codebase to 
the appropriate location on your server. If you backed up the codebase via the 
command line, use your FTP client to upload the backup tar. g z file into your 
staging directory. 

Then, SSH into your server and c d to your staging directory. Untar the codebase 
using this command: 

tar -xzvf backupcodebase.tar. gz 

The tar command extracts the codebase. From here, you can use the c p command to 
copy the codebase into your web directory. 

cp -pr backupcodebase /path/to/web/directory 

The actual path to your web directory will vary from server to server. If you don't 
know the path to your web directory, you can use your FTP client to figure this out, 
as shown by Item 1 in the screenshot before the preceding one. 

Edit settings.php 

Once you have moved the codebase into the web directory, you will need to edit the 
setti ngs. php file so that it points at the correct database. The setti ngs. php file is 
located in the sites/default directory. You can edit this file using any text editor, 
or any more-advanced authoring tool, such as Dreamweaver or Zend. 

Even though you can open the setti ngs, php file using a word 
processor, don't do it! Word processors add in spaces and formatting that 
will render the setti ngs, php file useless. 
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As shown in the highlighted section in the following screenshot, you will need to 
edit three values: 

1. Username for the database 

2. Password for the user 

3. Database name 



TO provio* prefitc? for >pt ( I tit latln, **t Mb.prcfla m tf trrtf, 
mrt» t % kfjt or# |IO tiftU matt and hi itUat arc |l» pc cf 1 *CV 
HO d*f#irlt tl ia o a lolpt i*» pr#fl» for py Ulltt not tpK'Utd 
In IN array lamplti 

S4fe prcf la • ar r ay ( 

0#faa»l( ' •> atm,', 

atoi 'tfvML' 

tattioo' •» 'tnoroC. 

rot# ®» 

julfimap -> if .at Cu_ 

"sequences’ => "shared. 

* ); 

1k 

* Database URL format: 

* $db_ur1 = "mysql ://username:password<Moca1host/databasename"; 

* $db_ur1 = "mysqli://username:password@1oca1host/databasename"; 

* $db_ur1 = "pqsql://username:password@1oca1host/databasename"; 

V 

$db_ur1 = "mysqli ://drupal6:drupal6@1oca1host./drupal6'; 

$db_prefix = ''; a 2 3 

/** 

matt control Tor tpttia pro »«»tpt 

Jf yO* tra tpdtlln) yor Or<pal Intlll III lap art Inf Ho tpdlla pTp acrtpt 
b#lno not I 0990 O In at adtlMt|ratCC. yoo all" r oa d to 1*001 fy IN Ktatt 
<To<* tuicmri boloc (Nnya IN • *4It to a IM to OtatU in* matt 
(N<l after flnttMng IN tpprfta. I* taro to Op in IMt nil tptla 

art cNtnp* in tout boct to a inti" 
tipoaii.fra«.man • Hitt; 

* l ata M (optional). 


Edit these values, save your changes, and then replace the old setti ngs. php 
file with the new file, and your backup is complete. You can test the backup by 
navigating to the homepage of your new site. You will see an exact replica of your 
existing site. 

Congratulations! You are now running your website with the security of a solid 
backup procedure. 
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The Test Site 

If you want to experiment with Drupal by installing additional modules, a test 
site provides a safe place to do this. For all of the obvious reasons, your live class 
site is not the place to experiment or take chances. Although installing a test site is 
additional work, it provides you a safe place to learn and experiment without fear 
of consequences. 

Fortunately, the process of verifying your backup, as described in the previous 
section, also gets you your test site. 

The test site is the site that you should use when you are trying something new, 
from evaluating a new module or theme, to testing an upgrade procedure. Using 
the test site allows you to take chances you would not otherwise be able to take. For 
example, if you want to try a new module, you can install it and experiment with 
the functionality and settings on your test site. If the module does what you need, 
then you can deploy it on your live site. If, however, the module does not meet your 
needs, you can just wipe out the database and start from scratch. 

Your test site is also the place where you should test all upgrades before you perform 
them on your live site. Even though upgrades almost always occur seamlessly, you 
are in a much better place if you spot the problem on your test site. 

Disaster Recovery 

By using the backup strategy described in this chapter, you can recover your site 
relatively quickly using your most recent backups. If your server crashes, or if some 
other technological disaster befalls your site, the first step is to contact your web 
host or tech support to inform them that your site is down. In most cases, problems 
involving a website going down (and this applies to all sites, not just Drupal sites) 
has nothing to do with the site, but with the hosting infrastructure. Fixing the issues 
with the web server, or the connection to the web server, usually fixes the problems 
with the site. 

However, should your actual site become compromised, here is how to recover: 

1. Retrieve your most recent backup of the files directory 

2. Retrieve your most recent backup of your database 

3. Retrieve your most recent master backup 

4. Within your master backup, replace the files directory atsi tes/defaul t 

5. Replicate your site as described in the previous section 
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Updating Your Site 

Drupal sites require periodic upgrades. These upgrades should be considered part of 
the maintenance process, and Drupal includes a core module — Update status — that 
simplifies this process. The Update status module provides an overview of the 
modules installed on your site, and informs you if they are out of date. 

Make sure that the Update status module is enabled by clicking the 
Administer | Site building | Modules link, or by navigating to 
a d mi n / b u i I d / mo d u I e s. 

The Update status module informs you of two main types of upgrades: 

• maintenance 

• security 

A security upgrade patches a security hole, and requires an immediate upgrade. A 
maintenance release adds functionality, or fixes non-critical bugs. Whenever there 
is a new core Drupal release, you should upgrade your site to the new release. For 
contributed modules, maintenance releases should eventually be included, but, 
unlike security releases, they are not an immediate priority. 

The updates page is available at Administer | Reports | Available Updates, or 

http://yoursite.org/ad mi n/reports/updates. 



Available updates 


Settings 


Here you can find information about available updates for your installed modules and themes. Note that each module or 
theme is part of a "project", which may or may not have the same name, and might include multiple modules or themes 
within it. 


To extend the functionality or to change the look of your site, a number of contributed modules and themes are available. 

Last checked: 37 sec ago (Check manually) 

Drupal core 

Drupal 6.x-dev (2008-Jan-07) Security update required! O 

Security update: 6.0-rc2 (2008-Jan-10) Download Release notes 

Development version: 6.x-dev (2008-Jan-28) Download Release notes 

Includes: Block, Blog, Color, Comment, Contact, Database logging. Filter, Garland, Help, Menu, Minnelli, Node, PHP filter. 

Path, Poll, Profile, Search, Statistics, Syslog, System, Taxonomy, Tracker, Trigger, Update status, Upload, User 
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Upgrading Core 

Before upgrading core, you should do two things: 

1. Back up your database, and test this backup by copying into an 
empty database. 

2. Back up the sites directory. The sites directory contains the files 
directory, the mo d u I e s directory, the t h e me s directory, and your 
setti ngs, php file—all of which are critical elements of your site. 

Once you have completed these steps, you are ready to proceed with your upgrade. 

Upgrading Core—The Short Version 

When performing a core upgrade, we will replace the old version of Drupal core 
with the updated version. This process involves three steps: 

1. Log into the new site as UID1; place the site in maintenance mode, and run 
update, php 

2. Download the new codebase from http://drupal . org/proj ect/drupal . 

3. Extract the Drupal codebase 

4. Delete the sites directory from the freshly downloaded codebase; replace it 
with the sites directory from your existing site 

5. Replace the existing codebase with the new codebase 

Upgrading Core—The Detailed Version 

These more-detailed directions expand on the short version, and provide 
step-by-step instructions on how to upgrade via the command line. In these detailed 
instructions, the new site is prepared on the web server. For people who don't want 
to work on the command line, the new site can be prepared on your local computer, 
and then uploaded to the web server via FTP. 

Preparing the Upgraded Site 

1. In the same directory as your existing site, create a folder named 
upgrade_t emp. 

2. Download the latest version of core Drupal from http://drupal.org/ 
proj ect/drupal . Once you have downloaded the tar, g z file, use your FTP 
client to upload it to the upgradete mp directory. 

3. SSH into your server and c d to the upgrade_temp directory. 
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4. Using the command line, extract the Drupal codebase: 

tar -xzvf drupal_release.tar.gz 

5. Delete the sites directory from the newly-extracted Drupal codebase: 

rm-r pat h/ to/ new/ codebase/ si t es 

6. Using the command line, copy the sites directory from your existing site 
into the new codebase: 

cp -pr /path/to/Iivesite/sites path/to/new/codebase/sites 

^ On some operating systems, the command will need to be C p - p R 

At this point, the new codebase should be ready for the upgrade. To verify that all 
files have been copied to the right places, examine the upgradetemp directory using 
Is - a I at the command line or by navigating to the upgradetemp directory using 
your FTP client. 

Preparing the Codebase—Additional Notes 

In some cases, your site will have a custom p h p , i n i file, or a modified , h t a c c e s s 
file in the root of your Drupal install. If you have either of these modifications in 
your site, be sure to copy the modified files to your upgraded codebase. 

Also, in very rare instances, the upgrade will include changes to the setti ngs, php 
file. In this rare case, you will need to copy over the database name, database user, 
and database password from your old setti ngs, php file. Editing the setti ngs, php 
file is covered earlier in this chapter, where we described how to test your backup. 

Bringing the Upgrade Live 

1. Log in to your site as UID1. 

2. Click the Administer | Site configuration | Maintenance link, or navigate to 
ad mi n/setti ngs/site-mai ntenance, and put your site into Offline mode. 

3. Using your FTP client, navigate to the web directory on your server. Rename 
the folder containing the codebase for your existing site from f o I d e r n a me to 
fol dername_ol d. 

4. Using the command line, copy the upgradetemp directory (which contains 
the new codebase) into the web directory, and rename it to match the 

fol d e r n a me that was edited in step 3. 
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In some cases, there may be additional files stored within the web 
directory. If this is the case, you will need to delete the full Drupal 
codebase from the web directory, and copy the upgraded codebase into 
this directory. Both methods work perfectly well; however, one advantage 
of renaming the directories is that you have a working codebase on your 
server to roll back to if something goes awry during the upgrade process. 


5. Navigate tohttp://yoursi te. o r g / update, php. You will be presented 
with a wizard with four steps: Overview; Select Updates; Run Updates, and 
Review Log. Click the Continue button. 



6. At the Select Updates screen, click the Update button. The update process 
will continue through without the need for additional input. 
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7. Once the upgrade process has completed, test your site by logging in as 
different users, adding sample content, and so on. Even if the upgrade 
process was generally uneventful, a little extra time verifying a clean 
upgrade is never a bad thing. 

8. A best practice for upgrades involves a series of tests for users in different 
roles. For example, users in the teacher role would create an assignment in a 
group, view a student's assignments, and add a note about a student. 

9. Once you have verified a clean upgrade, delete the fol d e r n a me _ o I d 
directory, and the upgradetemp directory. 

10. Click the Administer | Site configuration | Maintenance link, or navigate to 
a d mi n / s e 11 i n g s / si t e - ma i n t e n a n c e , and put your site into Online mode. 

11. Perform a master backup of your site as described earlier in this chapter. 

Upgrading Contributed Modules 

Upgrading contributed modules is considerably easier than upgrading Drupal core. 

To update a contributed module, download the latest copy of the module and 
read the upgrade instructions. For most modules, these instructions are found in a 
r e a d me. t x t or in a separate upgrade, t x t file. 

Follow any module-specific instructions found in this file. In the overwhelming 
majority of cases, though, the following steps will work for a clean upgrade: 

1. Log in as UID1; click the Administer | Site configuration | Maintenance 

link, or navigate to a d mi n / s e 11 i n g s / si t e - ma i n t e n a n c e , and put your site 

into Offline mode 

2. In your s i t e s / a I I / mo d u I e s directory, delete the old version of the module. 

3. Upload the new version of the module 

4. In your browser, navigate to http: / /yoursi te, o r g / update, php and run 
through the Upgrade wizard 

5. Click the Administer | Site configuration | Maintenance link, or navigate to 
ad mi n/setti ngs/si te-mai ntenance, and return your site to Online mode 

6. Perform a master backup of your site, as described earlier in this chapter 

If you have multiple contributed modules to upgrade, you should run the upgrades 
one at a time. This way, if one module has an issue with the upgrade, you will know 
exactly where the problem lies. 
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Upgrading Your Theme 

Theme upgrades occur very infrequently, and are rarely required for security 
reasons. The Upgrade status module will tell you if there is a new version of your 
theme available. However, if you have made changes to your theme by modifying 
the actual files or style sheets within the theme, note that an upgrade will eliminate 
your changes unless you specifically preserve them. In short, although the theme 
should be upgraded if there is a security problem (which is extremely rare), themes 
generally don't require upgrades. 

Should your theme require an upgrade, you should download the new version of 
the theme, and look for any upgrade instructions within a r e a d me, t x t file or an 
upgrade, t x t file. In the absence of any other instructions, delete the old theme 
directory, and upload the new theme in its place. 

Summary 

The work involved in setting up a backup strategy, and in maintaining your site 
through security upgrades, can feel overwhelming. However, one thing worse than 
struggling through setting up a backup strategy is attempting to recover your site 
after a server crash without a backup strategy. 

A backup strategy, combined with a test site, allows you to run your site with fewer 
worries. The test site also provides a place in which you can experiment with new 
options without fear of consequences. 
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Working Effectively in the 
Drupal Community 

Using an Open Source tool has many benefits, and the Drupal community offers 
a wealth of knowledge and experience. The Drupal community is an international 
group, with a diverse base of users. However, making your way in the community, 
especially if you are new to Drupal in particular and Open Source in general, can be 
daunting. The guidelines in this chapter will help you get acquainted with how to 
work effectively in the world of Drupal. 

Getting Started 

Within the Drupal community, numerous support venues exist. However, for better 
or for worse, questions that show that some research has preceded the question have 
a better chance of getting responses. As a consequence, more detailed questions are 
taken more seriously, and stand a better chance of getting a detailed response. 

Additionally, you gain credibility through participation in the community over time. 
One of Drupal's main strengths is the depth of knowledge and experience of the user 
community; by asking questions, and whenever possible, answering the questions 
of others, you become a member of the community. Most importantly, people 
new to Drupal bring fresh perspectives to the project. Many of the people asking 
questions are new adopters, and there is no need to feel that you are an expert before 
answering a question. 

Researching on Drupal.org 

When looking for information from the Drupal community, you should generally 
start by searching through the information that has already been created. Reading 
the handbooks and searching on D r u p a I , o r g can help answer many questions 
quickly, with minimal effort. 
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Searching Effectively 

The Drupal community search feature, at http:/ /drupal . org/search, can often 
yield good results. The advanced search, as shown in the following screenshot, 
allows you to narrow the scope of your search and focus on specific subjects or 
content types. 




S earch 

J Content [ | IRC nicks [ [ Users | | Issues 


Enter your keywords: 


[ Search 


» Advanced search- 


Containing any of the words: 


Only in the category(s): 


Containing the phrase: 


Containing none of the words: 


Advanced search 


Documentation Download Support 


Forums 

Support 

-Before you start 
-Installing Drupal 

f * IT*)-: 1 


-Post installation 


-Converting to Drupal 


-Module development 


-Theme development 


-Translations 

,Y;| 


Only of the type(s): 

□ Book page 
D Forum topic 
D Image 

D Issue 

□ Newsletter issue 

□ Page 

□ Project 

□ Project release 
D Story 


You can also use Google's site-specific search feature by adding the text site:drupal. 
org onto the beginning of your search string. This focuses your search onto 
Drupal , org itself, and is often the most effective way to start finding an answer 
to your question. 

Handbooks 

The handbooks contain a blend of generalized information and more specialized 
information. Browsing the handbooks can often yield unexpected gems and ideas, 
and they contain a wealth of information. For example, this page on videocasts 
contains some amazing resources: http://drupal.org/handbook/custo mi zation/ 
vi deoc as t s. 

Reading the handbooks is a great way to start researching an issue in Drupal, and the 
process of reading the handbooks can help you learn many details quickly. However, 
for precise answers to specific questions, you have other resources at your disposal. 
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Browsing the Issue Queue 

Every module on D r u p a I . o r g has a project associated with it, and every project has 
an issue queue. The complete issue queue can be found at http://drupal.org/ 
project/issues, and the issue queue allows you to filter on specific modules. The 
projects associated with each module are used to track potential bugs and questions 
about the specific module. If you are having problems/issues with a specific module, 
you can often find other users reporting similar issues. 

If you end up needing to post a question about a module, you should include the 
fact that you looked at the issue queue before asking; the fact that you have searched 
the issue queue shows a level of research and attention to detail that gives you 
more credibility. 

Asking Questions 

If your research doesn't get you what you need, then it's time to start asking 
questions. To begin unraveling your issue, read through the FAQ at 
http://drupal . org/Troubl eshooti ng-FAQ.If your answer is not covered 
here, then it's time to start asking questions. 

Support Forums 

The support forums, available at http://drupal.org/forum, are a good place to 
start asking for help when you need it. 

When asking questions in the forum (or really, in any of the support areas for 
Drupal) you can take steps to make it easier for people to help you. 

1. Describe the research you undertook prior to asking the question. Did you 
search using Google? Did you look at the issue queue? Were there any 
other forum threads or handbook pages that seemed to give some of the 
information you need? If so, link to those pages. The more detailed you can 
be in your question, the more specific people can be when responding. 

2. Ask, don't demand. The overwhelming majority of people responding to 
questions on D r u p a I , o r g are doing it in their own time. While it can be 
frustrating to ask a question and not get a response, nobody is required to 
answer questions on the forums. Generally, people who make demands 
often get reminded of the proper forum etiquette, but they also get actual 
answers less frequently. 


[ 369 ] 


[packtI 

L PUBLISHING J 


This material is copyright and is licensed for the sole use by lawrence rambert on 16th June 2009 
2012 price st,, rahway, , 07065 





Working Effectively in the Drupal Community 


3. If a response rubs you the wrong way, try not to escalate the tension. Drupal 
is an international community, and miscommunications can occur due to the 
language barrier. At times, people are just plain rude. If someone responds to 
you in a way that doesn't feel right, take the high ground. While you may feel 
justified at responding to a sharp exchange, it probably doesn't do much to 
get your question answered. 

4. Give your posts a meaningful, descriptive title. The more someone can glean 
from the title, the better the chance that they will read your full post and try 
to respond. 

If you ask a question that does not draw a response, don't take it personally. There is 
a lot of traffic on D r u p a I . o r g, and many questions get overlooked simply due to the 
vagaries of timing. 

For the forums, all recent posts show up athttp://drupal .org/tracker, and this 
is where most people looking to answer questions or get a sense of activity in the 
forums start looking. Putting a comment on your own post (a practice known as 
bumping) is generally frowned upon if done frequently, or after too short a wait. 
However, if your question remains unanswered for one or two days, you should feel 
free to post a follow up response on your initial question to bump it back to the front 
page of the tracker. 
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Chapter 16 


Finally, when someone does respond to your question, thank them. And, if no one 
responds to your question but you figure out an answer on your own, post back on 
your thread with your answer. You can be sure that someone else will have the same 
problem at some point, and will find your thread and get the answer they need. 

Support Mailing List 

The support mailing list offers similar support to what you find in the forums, 
and the same rules regarding questions apply. Many people swear that they get 
better results on the mailing list, while others swear by the quality of support on 
the forums. In general, both resources are excellent places to get answers. You can 
subscribe to the Support list at h 11 p: / / d r u p a I . o r g / ma i I i n g - I i s t s. 

Groups.drupal.org 

The Groups site, located athtt p: / / groups, drupal . o r g , contains affiliated 
groups organized by geographic location, area of interest, and functionality. For 
example, the site has a Portland, Oregon users group, several groups dedicated to 
education-related issues, and groups organized around building social networking 
sites. If you are working on a site to achieve a specific goal, you can often find people 
within a group working on a similar goal. 

Additionally, the "Drupal in Education" group is, as the group name suggests, 
focused on different uses of Drupal in Education. This group can be found at 
http://groups. drupal. org/drupal-educati on. 


IRC 

An additional resource for finding support and working within the Drupal 
community is IRC, or Internet Relay Chat. IRC is often the best option for finding 
answers in a hurry. It is also the best method to quickly develop a reputation within 
the Drupal community, as the subset of people found on IRC tend to be among the 
more active participants in the Drupal community. 

You need an IRC client to join IRC; one of the easiest to install and use is an 
application called Chatzilla, available as a Firefox add-on at h 11 p s: / / a d d o n s. 
moziI I a.org/en-US/fi refox/addon/16. 

The Drupal handbook athttp://drupal . org/node/ 108355 has an excellent 
overview of using IRC. 

The IRC channel for Drupal support is #d r u p a I - support on Freenode at 
ht t p://f r eenode. net. 
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Giving Support 

People who use Drupal for any length of time reach a point where they become 
capable of answering questions for other users. Helping out in the forums, writing 
up a case study describing how you used Drupal, or joining the documentation 
team and helping to write the handbooks are all ways that non-programmers can 
contribute to Drupal. By giving support to other users as time allows, you help to 
keep the project moving forward. Contributing back to the community also allows 
you to begin building a network of contacts within the community, and these 
contacts can help you as your needs become more complex. 

For a starting point for how you can get more involved in the Drupal community, see 
http://drupal. org/contri bute. 

Summary 

When you have a question about using Drupal, the community contains resources 
that can help you out. By searching existing resources and asking effective questions, 
you can lean on the community to help you when you need it. As you increasingly 
use Drupal over time, you will start to be able to help others in similar situations. 

And at that point it's only a matter of time before you come home with a 
Druplicon tattoo... 
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extend Drupal 

2. Control access with users, roles and 
permissions 

3. Structure your content using Drupal's powerful 
CMS features 

4. Includes coverage of release 4.7 


Please check www.PacktPub.com for information on our titles 
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Learning Drupal 6 Module 
Development 

ISBN: 978-1-847194-44-2 Paperback: 310 pages 

A practical tutorial for creating your first Drupal 6 
modules with PHP 

1. Specifically written for Drupal 6 
development 

2. Program your own Drupal modules 

3. No experience of Drupal development 
required 

4. Know Drupal 5? Learn what's new in 
Drupal 6 


5. Integrate AJAX functionality with the 
jQuery library 


6. Packt donates a percentage of every book 
sold to the Drupal foundation 



Drupal Multimedia 

ISBN: 978-1-847194-60-2 Paperback: 241 pages 

Create media-rich Drupal sites by learning to embed 
and manipulate images, video, and audio 

1. Learn to integrate multimedia in your 
Drupal websites 

2. Find your way round contributed modules 
for adding media to Drupal sites 

3. Tackle media problems from all points of 
views: content editors, administrators, 
and developers 


Please check www.PacktPub.com for information on our titles 
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